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Editor's Page 



Eight Bit Systems are NOT Dead! 

Various publications have carried 
death notices for CP/M and S-100, but 
despite these announcements there is 
still a lot of life in these old systems. 
It's true that the selection of new har- 
dware has been limited and the number 
of new systems sold is small compared 
with the IBM-PC, but the CP/M 
systems serve their purpose and many 
people will continue to use them until 
there is something with significant 
operating improvements available. 

Some people in the industry have lost 
track of CP/M because they don't see 
flashy multi-million dollar advertising 
for new CP/M hardware and software. 
Those integrated do-everything 
program and appliance computer ads 
are for the non-technical business com- 
puter users who aren't sure what har- 
dware or software they really need. 
The CP/M and other eight bit users are 
quietly using the thousands of available 
programs to do what they want without 
a lot of fuss and excitement. 

The new eight bit products are for 
the programmer or developer who per- 
sonally works with the computer and is 
interested in what they can do with 
computers, while the IBM-PC type 
products are for business users who are 
interested in what the computer can do 
for their business. A recent survey 
disclosed the interesting fact that a 
large percentage of computerists who 
were supplied with an IBM-PC at their 
work place chose a CP/M or Apple II 
system for their personal computer at 
home for non-employment related use. 
Business users who wanted to continue 
word processing, spreadsheet, or other 
business related work at home of cour- 
se chose a computer compatible with 
the one at work. 

It appears that the IBM-PC is firmly 
established as the first choice for ap- 
pliance type business applications 
(mainly because of the large number of 
business software programs). The IBM- 
PC market is primarily for business use 
software and hardware enhancements, 
and there is also a large market for 
programming utilities for the people 
developing products for this market. 
The new products for the CP/M market 



are for multiuser and industrial har- 
dware, programming languages and 
utilities, system enhancements; and 
peripherial devices, SBC microcon- 
trollers, and sensors for interfacing to 
the real world. 

Some of the companies supplying 
new CP/M software are BV 
Engineering (Engineering programs), 
Softaid (MTBASIC), Echelon (Z-System 
enhanced operating system), Softad- 
vances (DSD 80 debugger), Barnes 
Research & Development (BMON sof- 
tware In-Circuit Emulator), Poor Per- 
son Software (utility programs), 
Dynacomp (Engineering programs), 
Public Domain Software Center (rents 
public domain software), Hayden 
(Structured Assembly Language 
Programming for the Z-80), SLR 
Systems (Z80 assemblers and linkers), 
and Afterthought Engineering 
(Wiremaster wire wrap and PC layout). 
There are others, but these are ones 
with which I am currently working. 
You'll notice that these are all tools or 
Engineering programs, not general 
purpose business programs for the un- 
sophisticated user. 

The 8-bit systems that we are using 
are not the final answer, and we will be 
changing to 16-bit or 32-bit systems in 
the near future, but it is not necessary 
to abandon what we are now using (if it 
is doing the job) to replace it with other 
hardware currently being offered. By 
incorporating new chips and enhanced 
operating systems we can continue to 
use what we have with little or no 
disadvantage until we upgrade to 
equipment with improvements which 
are not ready at this time. 

Hitachi HD64180 Superchip 

One of the developments which will 
enable us to greatly improve the per- 
formance of our CP/M systems is the 
new HD64180 CPU which is upward 
compatible with the Z-80 and 8080 in- 
struction sets. I am still watting for 
more information, but it has MMU 
(Memory Management Unit) control of 
512K byte physical address space; two 
channel DMAC with memory memory, 
memory-IiO, and memory memory 

(continued »« pog* 361 
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Build the Circuit Designer 1 MPB 

Part 1: Designing a Single Board Computer 

by Neil Bungard 



Introduction 

Since the microcomputer revealed it- 
self to the public in the early 70's its 
applications have branched into two 
distinct catagories: 

1. Computer systems 

2. Controllers 

Computer systems are primarily 
used to do iterative numerical 
calculations and store relatively large 
retrievable data bases. They typically 
use higher level languages, and the 
system electronics is complicated. 

A microprocessor used as a con- 
troller typically does not spend much 
time doing numerical calculations. Its 
time is spent making decisions, input- 
ting and outputting, and the majority of 
the programming on these systems is 
done in assembly language. 

Circuit Designer-1, MPB is a single 
board computer which is specifically 
suited for control applications. It 
utilizes an Intel 8035 CPU and has the 
following "on board" capabilities. 

4K of external program memory. 
64 bytes of data memory on the CPU. 
'A K of external data memory. 
Ability to generate 256 I/O device 

and/or control bytes. 
8 decoded input device pulses. 
8 decoded output device pulses. 
12 bit address bus interface. 
8 bit bi-directional data bus interface. 
8 bit parallel I/O port interface. 
CPU control signal interface. 
Software controlled event counter. 
Software controlled interval timer. 
Single step capability. 
Power up reset. 

The circuit Designer-1 MPB is truely 
a smart, single board control device and 
with a simple memory circuit, which 
will be presented in this article, CD-I 
becomes an affordable dynamic 
training tool for understanding and 
using chip level microprocessor 
techniques. Alternatively, one can use 
EPROMs or EEPROMs, an inexpensive 
personal computer, and a commercially 
available 8048 assembler to utilize the 
CD-I as a cost effective development 
system. This configuration will be 
discussed in a subsequent article. 



Circuit Description 

The simplest method of understan- 
ding any system is to break the system 
into its component parts, gain an un- 
derstanding of their operations, then 
determine the interaction of the com- 
ponent parts within the system. CD-I is 
divided into nine component parts 
which should complete a functional 
description of its "on board" 
capabilities. A complete schematic 
diagram is shown in Figure 10. 

The CPU. The heart of CD-I, MPB is 
the CPU. The CD-I utilizes Intel's 8035 
CPU which is a member of the 8048 
family. The 8035, 8048, and 8748 are pin 
compatible microprocessors with dif- 
ferences only in the type and amount of 
resident program memory. The 8048 
has IK of masked read only memory 
which is programmed at the factory. 
The 8748 has IK of electrically 
programmable read only memory, and 
the 8035 has no internal program 
memory. A pin diagram of the 8035 is 
shown in Figure 1. Available on the 
CPU is an 8-bit bi-directional data bus, 
two 8-bit parallel I/O ports, five input 
control signals, five output control 
signals, two crystal connection inputs, 
and four power connection pins. The 
function of these individual pins will be 
discussed in detail as they are used in 
the periphial circuits of the CD-I. 

Also resident on the 8035 is an 8-bit 
accumulator, a 12-bit program counter, 
and 64 bytes of scratch pad memory. 
The scratch pad memory is internal 
read/write memory and consists of 16 8- 
bit general purpose registers, a 16 byte 
stack, and 32 bytes of general storage 
memory. 

The Multiplexed Address Bus. You 
may have noticed the absence of ad- 
dress pins on the CPU. The 8035 uses 
bus multiplexing to derive its address 
lines, which reduces the number of pins 
required on the CPU. Refer to Figure 2 
for the address multiplexing circuit. 
For each external memory operation 
the CPU must latch the address of the 
current memory read, or memory 
write, operation. The eight lower order 
bits of the address are made available 



on Do through D7, and the four higher 
order bits are placed on P2o through 
P23. When the address information is 
stable, the CPU sends out a negative 
going pulse (ALE) which latches the 
address into two 74LS373's. Once lat- 
ched, the CPU uses this address to ac- 
cess either program or data memory. 

Program Memory. The program 
memory is the only memory space that 
can contain program instructions. The 
8035 multiplexes 12 program memory 
address lines (Ao through An). This 
means that the CPU is capable of ad- 
dressing 4096 (212) memory locations. 
Refering to Figure 3, Ao through A10 
are obtained directly from the 74LS373 
address latches. Address bit An is 
decoded via a 74LS32 and a 74LS86 to 
determine which 2K program memory 
block ( which 2716) is to be addressed. 
PSEN is the pulse which strob es the in- 
struction into the CPU. When PSEN 
goes low it will be "ORed" with An and 
A"n. Tn e result of this "ORing" will 
output a low pulse to the CS on the ap- 
propriate program memory. The active 
memory will then supply an 8-bit word 
which is strobed into the instruction 
register via the data bus. 

There is a subtle characteristic con- 
cerning the program memory which 
you should be aware of. The CPU can- 
not write into program memory. 
Program memory is read only memory 
(ROM). This means that if you wish to 
write dynamic programs into the CD- 
I's program memory that it must be 
done via direct memory access (DMA). 
This will be explained in detail later in 
this article. 

As I have mentioned before, program 
memory is used to store CPU instruc- 
tions. The 8035 retrieves the instruc- 
tions from program memory by the 
following sequence of events: 

1. The 8035's internal program coun- 
ter contains the address of the next in- 
struction to be fetched. 

2. The CPU makes available the con- 
tents of the program counter to the ad- 
dress bus multiplexer (two 74LS373'sl 
via Do through D7 and P2q through 
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P23, and latches this address infor- 
mation into the 74LS373's by pulsing 
ALE low. 

3. With the address latched into the 
74LS373's, it is available on the address 
inputs of the program memory. The 
CPU then pulses PSEN low and the in- 
struction contained in the applied ad- 
dress is strobed into the CPU's instruc- 
tion register and executed. 

External Data Memory. External 
data memory is read/write memory. It 
has its own set of read/write control 
signals generated by the CPU, R~D and 
W"R respectively, and it has a unique 
set of instructions for its operation. The 
CPU's program counter cannot be set in 
this memory space so that the data 
placed in this space cannot be used as 
program instructions by the CPU. This 
memory is used primarily for data 
storage. Refer to Figure 4 for the cir- 
cuit diagram of the data memory. When 
the CPU wants to read data from, or 
write data to, the data memory it must 
first output a memory address, as it did 
for the program memory. The extermal 
data memory uses only the eight lower 
order address lines so that a maximum 
of 256 (2°) memory locations can be ac- 
cessed. Once the address is latched into 
the 74LS373 it goes directly to the two 
2112's (256 x 4 random access 
memories). If the CPU wishes to do a 
memory read it will pull RD low which 
will pull CS on the 2112's low, causing 
the 2112'sjo be activated. With RD ac- 
tive low, WR will be high causing the 
memories to be in the read mode. Since 
the 2112's are 256 x 4 bit memories, two 
2112's are required to create 8-bit wor- 
ds. The 2112's place their 4 bits each on 
the data bus, and the CPU strobes this 
data into its accumulator. If the CPU 
wishes to do a memory write it will 
place the data on the data bus and puli 
WR low. With WR low thememories 
are inthe write mode. A WR low also 
pulls CS on the 2112's low activating 
the memories and writing the data into 
them. On the CD-I only the upper 248 of 
the 256 external data memory locations 
can be utilized as memory. The eight 
lower locations are used for I/O device 
code generation. This is explained in 
detail below. 

The I/O Device Codes. Com- 
munication with external input and 
output devices are accomplished by two 
methods on the CD-I. The 8035 can 
communicate with external devices 
through its parallel I/O ports, or it can 
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Figure 2: Address Multiplexing Circuit. 
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use memory mapped I/O (MMIO). When 
using MMIO the 8035 must use its ex- 
ternal data memory space. This means 
that the external data memory must 
share its 256 possible memory locations 
with the I/O devices. The circuit for ac- 
complishing MMIO on the CD-I is 
shown in Figure 5. When performing 
MMIO, the CPU is actually doing a 
memory read or a memory write 
operation to external data memory. 

Address lines Ao through A2 of the 
external data memory are decoded by 
two "3 to 8 line" decoders (74LS138's). 
WR from the CPU is connected to the_ 
enable of one of the 74LS138's and RE 
is connected to the enable of the other 
74LS138. The remaining address lines 
are decoded through the 74LS260 and if 
any of these address lines are high, 
both 74LS138's are disabled. This 
allows memory locations 000H through 
007H to be uniquely decoded on the 
outputs of the 74LS138's. If a memory 
read is being performed R"E will be ac- 
tive enabling the "input device code" 
74LS138 and one of the eight input 
device code lines will then go low. This 
negative going pulse will be used to 
strobe information onto the data bus 
from an external device. If the CPU is 



performing a memory write, WR will 
be active and the "output device code" 
74LS138 will be enabled, generating a 
unique device code pulse which is used 
to strobe the data being output by the 
CPU into an external device. 

One important characteristic must be 
considered when performing MMIO 
operations with the CD-I. The CPU will 
perform external data memory 
operations and generate device code 
pulses aimutaneoualy. This will cause 
bit conflicts on the data bus when input 
device operations are performed for all 
but the eight "on board" device codes 
(the external data memory is 
automatically disabled for these eight). 
For the remaining 248 possibilities it is 
the responsibility of the external 
devices to disable the external data 
memory's output while the devices are 
writing to the CPU. This is done by 
placing a logic "1" on the input control 
pin "Memory Disable" of the external 
memory (Figure 4). 

Eight input and eight output device 
code pulses are generated "on board" 
by the CD-I, and with additional cir- 
cuitry as many as 256 I/O devices may 
be controlled directly. 
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8-Bit Parallel I/O Port. The 8035 has 
two 8-bit parallel I/O ports (see Figure 
1). I/O port 1 is divided into two 4-bit 
words. The four lower order bits Plo 
through PI3, are used to output the 
four higher order address bits, Ag 
through An- These bits are output to 
the address bus multiplexing circuit 
(9ee Figure 2). The four higher order 
bits of port 1, PI4 through PI7 are used 
by the priority interrupting circuit 
which will be discussed later. Since I/O 
port 1 is used for "on board" operations 
it is not available for interfacing on the 
CD-I. Parallel I/O port 2, however, is an 
interfacing option. The eight pins of I/O 
port 2 on the CPU go directly to an in- 
terface socket on CD-I, and I/O port 2 
has a unique set of inputting and out- 
putting instructions to control its 
operation. The major characteristic to 
consider when using I/O ports 1 or 2 is 
that they are quasi-bidirectional. This 
implies the following characteristics: 

1. When parallel data is output on I/O 
port 1 or 2 the data is automatically lat- 
ched and held on the port by the CPU 
until the next operation. 

2. When using an I/O port for input 
you must first set the inputting bits to a 
logic 1 via an output instruction. The 
only way external logic can input data 
to I/O port 1 or 2 is by pulling individual 
pins from a logic 1 to a logic 0. External 
logic cannot create a high level on any 
pin of I/O port 1 or 2 once it has been set 
low via an output instruction. 

Eight Level Priority Interrupt. The 

interrupt function is typically one of the 
most interesting circuits in control 
computer application. The CD-I is no 
exception, as it contains an eight level 
priority interrupt capability. The 
priority interrupt scheme of the CD-I is 
both software and hardware depen- 
dent. The circuit for the priority in- 
terrupt scheme is shown in Figure 6, 
and the software flow chart is shown in 
Figure 7. 

Requesting an interrupt is accom- 
plished by first executing an external 
interrupt enable instruction (the in- 
terrupts on the 8035 are always 
disabled when the CPU is reset). Next 
the interrupting device must place a 
logic on one o f the C D-I's int errup t 
request inputs (INTo through INT7). 
The interrupt request lines are "AN- 
Ded" through a 74LS30, and when any 
interrupt line goes low, a logic is ap- 
plied to the TOT pin (Pin 6) on the CPU. 
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If the CPU sees a logic on its INT in- 
put, and the external interrupts have 
been enabled via a program instruction, 
it will react in the following manner: 

1. The 8035 will complete the instruc- 
tion it is currently executing. 

2. The 8035 will execute a call in- 
struction to program memory location 
003H. 

The software routine for deter- 
mining interrupt priorities can be 
placed at location 003H or it can be 
placed elsewhere in program memory 
and a jump instruction placed at 003H 
directing the CPU to the priority in- 
terrupt routine. 

Referring to Figure 6, the interrupt 
request lines are tied to the inputs of a 
74148. The 74148 is an 8 line to 3 line oc- 
tal priority encoder, and its truth table 
is shown in Table 1. Referring to Table 
1, pins Ao through A2 on the 74148 out- 
put a binary number which represents 
the highest priority input which is set 
to a logic 0. Ao through A2 are also 
connected to the four highest order bits 
of I/O port 2 on the 8035, and upon 
being interrupted the CPU is instruc- 
ted to immediately input I/O port 2 to 
the accumulator. All bits except bits 4, 
5, and 6 are then masked out, and com- 
parisons are executed in order to bran- 
ch to the appropriate service routine. A 
program listing of the procedure is 
shown in Figure 8. Immediately after 
the branch is accomplished the service 
routine should acknowledge that the in- 
terrupt has been received. This is done 
via a negative going pulse on the ap- 
propriate interrupt acknowledge 
(IACK ) outpu t of the CD-I (see Figure 
6). The IACK is generated in the 
following manner: 

A 3-bit binary word representing the 
service routine being executed is out- 
put on Ao through A2 of the 74148, and 
is also present on Aq through A 2 of a 
74LS138 (a 3 line to 8 line multiplexer). 
The truth table of the 74LS138 is shown 
in Table 2. With a 3-bit binary word on 
Ao through Ajofthe 74LS138, the 
CPU can pull TACK low by outputting a 
logic on P7 of I/O port 2. P7 of I/O port 
2 is tied to the enable pin of the 
74LS138 and when this line goes low. 
the interr upt is a cknow ledged. The ap- 
propriate IACK (IACKo through 
IACK7 is tied to the interrupting 
device and signals the device to remove 
its interrupt request. 
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Comments 



:Set INTA Lo 

Set P2 for input 

Input P2 (interrupt identification) 

Save interrupt identification 

:Set INTA Hi 

:Reclaim interrupt identification 
to accumulator 

:Is interrupt identification OOh? 

:If so jump to service 

:Ifnot 

: Reclaim interrupt identification, if so 



:Do the same for all 8 possible 
interrupting devices 



: Reclaim interrupt identification 
:Is Interrupt identification 074? 

:If so jump to service 
:If not 

:Return 



Figure 8: Program listing of Branch To Service Routine. 
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Table 2 

Typically the advantages of in- 
terrupts are: 

1. The Computer can execute its main 
task and not be concerned with polling 
its servicable devices. 

2. Interrupts should have a speed ad- 
vantage over polling devices. This ad- 
vantage may or may not occur using the 
CD-I since the priorities of the in- 
terrupting devices are determined via a 
software routine. However if a single 
interrupt is to be handled by the CD-I, 
then the service routine for that single 
device may be placed at memory 
locations 003H and the speed advantage 
over polling a particular device can be 
realized. 

Programmable Event Counter & In- 
terval Timer. A programmable event 
counter and interval timer are resident 
on the CPU of the CD-I, which means 
that no external circuitry is required to 
support these functions on the CD-I. 
The 8035 contains a counter/timer 
register which is accessed via the ac- 
cumulator and initial values are loaded 
into this register with specific program 
instructions. The counter/timer is also 
started and halted using program in- 
structions and a summary of the coun- 
ter/timer instructions and their fun- 
ctions are shown in Table 3. 

High-to-low logic transitions on pin 
39 of the CPU increment the coun- 
ter/timer register. Furthermore, when 
the counter/timer register is incremen- 
ted from FFH to OOH, two events occur 
simultaneously: 
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1. A counter/timer interrupt request 
is generated which initiates a call to 
program memory address 007H. 

2. A "time-out" flag is set, which may 
be tested by executing a JTF branch- 
on-condition instruction. 

The counter/timer may be operated 
as a timer by executing a STRT T in- 
struction. In this case the internal 
system clock increments the timer 
register every 80 microseconds, 
assuming a 6 MHz crystal. The coun- 
ter/timer may also be operated as a 
counter by executing the STRT CNT 
instruction, and when this is done, high- 
to-low transitions on the signal input at 
Tl (pin 39 on the 8035) increments the 
counter. The minimum time interval 
between high-to-low transitions on Tl 
is 7.2 microseconds, and there is no 
maximum time restriction between the 
high-to-low transitions. Once Tl goes 
high it must remain high for at least 100 
nanoseconds. 

JFT — Jump on current page if timer 
has timed out, that is, if timer flag is 
1. The timer flag is reset to zero 
by this instruction. 

MOV A,T - Read timer/counter. 

MOV T.A — Load timer/counter. 

STOP TCNT-Stop timer/counter. 

STRT CNT - Start counter. 

STRT T- Start timer. 

Table 3: Summary of Counter/Timer 
instructions and functions. 

The Single Step Circuit. A single 
step circuit has been included on the 
CD-I so that the processor can execute 
a single program instruction at a time. 
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Figure 9: Single Step Circuit. 



The single step circuit is shown in 
Figure 9. 

If you do not want the processor to 
single step, the "preset" input must be 
grounded via the SS select switch. This 
forces the "Q" output of the 74LS74 
high, and instructions will execute at 
normal operating speeds. If you wish to 
single step through the program, you 
must unground the "preset" input of 
the single step circuit, which will allow 
the "clear" input on pin 1 of the 74LS74 
to become active. ALE from the CPU is 
connected to the "clear" input of the 
single step circuit, and consequently, 
when ALE goes low the o_utput "Q" is 
also driven low; thus the SS input on 
the CPU goes low. Now when ALE 
next goes high, the CPU will maintain 
it high until the SS advance is 
depressed, and instruction execution is 
halted. Depressing SS advance creates 
a low-to-high transition on the "clock" 
input of the 74LS74 which forces the SS 
input on the CPU high, thus allowing 
the processor to advance one program 
instruction. It should be noted that 
while the CPU is stopped between in- 
structions in a single step mode, the 
current program counter contents are 
output via the data bus (Do - D7) and 
P2o-P2 3 . 

Single stepping is a valuable 
program debugging aid, and allows the 
user to cease the CPU's execution after 
each instruction and test conditions 
within the circuit under investigation. 

Conclusion 

In conclusion, the material presented 
in this article will enable the reader to 
construct, and understand, the CD-I 
single board computer. In addition, I 
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would like to emphasize that although 
this article presents the 8035 CPU in a 
single board configuration (CPU and 
several support IC's), the real virtues of 
the 8035/8748 lie in its minimum com- 
ponent configuration. The minimum 
componenent configuration for the 8035 
would be the 8035 itself, and one ad- 
dress latachable memory IC. The 
minimum component configuration for 
the 8748 would be the 8748! 

These "minimum systems" would not 
be extremely versatile, of course, but 
the point is that with no additional har- 
dware, switches and light emitting 
diodes could be connected to the CPU, a 
program entered, and the system could 
perform a useful function. Most CPUs 
are not designed to be used in this 
fashion, and consequently require a 
greater number of support ICs. 

In the next issue of The Computer 
Journal we will look at the instruction 
set of the 8035, and explain how to use 
the CD-I. In addition, we will discuss 
the idea of using read/write memory in 
the 8035's program memory space to 
enable you to write and execute simple 
programs using the CD-I single board 
controller. ■ 
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Using Apple II Graphics from CP/M 

Turbo Pascal Controls Apple Graphics 

by Ted Carnevale 







i ne of the most important features 
of the Apple II* family of microcom- 
puters is their built-in graphics 
capability. Programs that run under 
DOS, PRODOS, or the p-System can be 
enhanced by using the built-in graphics 
commands of Applesoft BASIC or p- 
System Pascal. 

However, graphics commands are 
generally lacking in high-level 
languages under CP/M® . This lack is 
ironic since Apples with Z80 cards ac- 
count for a major portion of the 
microcomputers that run CP/M. Fur- 
thermore, many of the CP/M cards have 
fast Z80s and extra RAM that make 
them more powerful than other CP/M 
microcomputers. A few Apple versions 
of some languages (e.g.MBASIC and 
Microsoft's FORTRAN) do include 
some graphics commands, but these 
implementations are incomplete and 
work only with the older, slower Z80 
boards. 

This article tells how I wrote a han- 
dful of routines that allow me to use the 
Apple's graphics features. These 
routines work on an Apple or (pre- 
lawsuit) Franklin with a PCP1 Ap- 
pliCard or Franklin Z80 board. The 
number of changes needed to make 
them work with other hardware is 
restricted to a few sections that tran- 
sfer data and commands between the 
Z80 and the 6502. The hardware- 
specific code is small, clearly identified, 
and easily replaced. Other 
modifications could be added to use the 
extended high-resolution mode of the 
He and lie. 

The Dilemma: Graphics or CP/M? 

We use CP/M on an S-100 bus 
microcomputer at the lab, but I was 
satisfied with DOS and the p-System at 
home for a long time. When I started to 
use the Apple to work on programs for 
the lab, I ran into trouble. 

Many of our data analysis programs 
are written in Turbo Pascal, which is 
just different enough from Apple's p- 
System Pascal to cause problems with 
program portability. Also, I had grown 
used to Turbo Pascal's compiler, which 



is much faster than the p-System com- 
piler. Finally, moving back and forth 
between different operating systems 
and editors was a nuisance. 

So I bought a Z80 card. The PCPI 
AppliCard seemed like a good choice. 
The Z80 on this board has its own 64K 
of RAM so it can run at 6mHz, 50 to 
300% faster than most dedicated CP/M 
micros! With an optional 128K RAM 
expansion used as a disk emulator, the 
AppliCard turns the Apple into a 
machine that can run circles around 
most other 8-bit micros. 

Before long, I was running WordStar 
and Turbo Pascal at home. It was great 
to be able to transfer files to the lab via 
modem, without having to worry about 
incompatibilities between DOS and 
CP/M! 

Then it came time to work on graphics 
programs. We were developing 
routines for our bitmapped graphics 
display in the lab, and I wanted to try 
out some ideas at home. However, 
there wasn't any commercially 
available software that would let me 
use the Apple graphics routines from 
CP/M. Borland International was 
unaware of any graphics extensions to 
Turbo Pascal, and PCPI didn't know of 
any high-level language that ran under 
CP/M which would do what I wanted. 

The Cluea 

The first step toward solving my 
problem was suggested by the Apple 
Reference Manual. This manual tells 
what addresses in the 6502's RAM 
correspond to the high- and low- 
resolution graphics pages, and where 
the soft switches are that activate 
graphics- or text- mode display. 
Machine language and Applesoft 
BASIC programs select among text, 
low-, and high-resolution display modes 
by activating one of these soft switches. 
Drawing on one of the graphics screens 
is accomplished by writing bytes to the 
proper addresses in one of the memory 
areas set aside for graphics display 
(graphics memory). 

The second step was to find out how 
to activate the soft switches and write 



to the graphics memory from CP/M. 
Some Z80 boards share the RAM on the 
Apple's motherboard with the 6502. 
With these boards, the Z80 might be 
able to write directly into the graphics 
memory and toggle the soft switches 
without the cooperation of the 6502. 

However, the AppliCard is actually a 
separate microcomputer with its own 
RAM. As far as its Z80 is concerned, 
the Apple is just a peripheral device 
that it communicates with through a 
parallel port. The details of this com- 
munication are described in PCPI's 
AppliCard OEM Manual This manual 
gives examples of how the Z80 can tell 
the 6502 to write one or more bytes to 
any address in the motherboard's 
RAM. 

Based on this information, I wrote 
some simple procedures in Turbo 
Pascal that passed data back and forth 
between the 6502 and the Z80, and 
combined them with other procedures 
that selected the display modes. Then I 
added a routine that was supposed to 
write a series of horizontal lines across 
the graphics screen of my choice. This 
was a crude, 'brute force' procedure 
that calculated the address of each byte 
in the Apple's display memory. 

The resulting program could draw 
lines across low resolution page 1 or 
high resolution page 2. Trying to write 
over low resolution page 2 or high 
resolution page 1 made the computer 
hang, so that it had to be turned off and 
rebooted. Apparently these locations 
were needed by the drivers that PCPI 
used for the 6502 to communicate with 
its peripherals. 

As limited as it was, this program 
was a success because it showed that 
what I wanted to do was possible. 
However, a lot more work lay ahead if I 
had to use this crude approach to draw 
lines and set colors. 

A Refinement: Tapping the ROMS 

The PCPI OEM manual also told how 
to make the 6502 execute a routine 
starting at a specified address. If I only 
knew where the routines to set colors 
and draw points and lines were located 
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in ROM and what parameters they 
needed, I could save a lot of program- 
ming effort. 

This information came from a book 
by Jeffrey Stanton entitled Apple 
Graphics and Arcade Game Design 
(The Book Co., LA, Calif. 1982). This is 
probably the single most complete 
reference on Apple graphics. The 
descriptions of the firmware graphics 
routines are actually only a very small 
part of the useful and fascinating 
material in this book. 

The Apple's ROMs contain machine 
language routines to draw points and 
lines and to select the colors used for 
drawing on the low and high resolution 
screens. These routines are used by 
Applesoft, and probably by p-System 
Pascal as well. 

In an Apple running CP/M with a Z80 
card, they are still in ROM waiting to 
be called by the 6502. All that has to be 
done is to load the correct parameters 
into the 6502's registers and RAM, and 
then make the 6502 call the graphics 
routine with a JSR instruction. For 
example, the 'hlin' routine that draws a 
horizontal line on a low resolution 
screen at row v between columns hi 
and h2 (where hi -4h2) starts at location 
$F819. It is called with the value of v in 
the A register, hi in the Y register, and 
h2 in location $2C. The other graphics 
routines are accessed in a similar man- 
ner. 

Calling the Graphics Routines 
From CP/M With Pascal 

The listings give the Turbo Pascal 
routines that I use to draw on the 
graphics screens from CP/M. I have 
grouped them into several include files 
according to function. This helps keep 
program size and compilation time to a 
minimum. 

However, it has the undesirable side 
effect of making the scope of some iden- 
tifiers (names for constants, variables, 
procedures or functions) global. Since a 
global identifier is defined outside of all 
procedures or function definitions, it 
may be referenced by any procedure or 
function. As a result, naming conflicts 
and other side effects may occur. To 
avoid these, identifiers which probably 
should be 'hidden' from most ap- 
plication programs start with an under- 
score, which Turbo Pascal allows as the 
first character of an identifier. 

The first of the include files is 
PCP.INC, which contains all of the 
elementary routines needed for the Z80 



to communicate with the 6502. These 
access the special functions that the 
AppliCard uses to transfer data back 
and forth between the 6502's RAM on 
the motherboard and the Z80's RAM on 
the AppliCard. Further details about 
these functions are contained in PCPI's 
AppliCard OEM Manual. Since the 
hardware and software supplied by 
other Z80 board manufacturers are dif- 
ferent, these routines would have to be 
changed before they are used with 
other Z80 boards. 

Most of the routines in PCP.INC 
write or read one or more bytes to or 
from the 6502's address space, and are 
used to set the 6502 up for graphics 
operations. They can also be used to 
write or read data directly to or from 
the graphics screens. The last 
procedure in this file is "callapl," which 
makes the 6502 perform a JSR to a 
specified location. 

Some constants and routines are 
common to both low and high resolution 
graphics. These include the addresses 
of the soft switches used to select 
among text, graphics, full screen or 
mixed graphics and text modes, and the 
routines that set these switches. These 
are gathered into APLGR/G.INC, 
which should be included after 
PCP.INC and before either APLGR/L 
or APLGR/H. 

The registers of the 6502 must be 
loaded with the appropriate 
parameters before it executes a JSR to 
one of the ROM graphics routines. Sin- 
ce PCPI didn't provide any way to load 
the registers, I decided to create my 
own routines for this purpose. 

These register-loading routines are 
written into an otherwise unused area 
in the 6502's RAM by special 
initialization procedures in two 
separate Turbo Pascal include 
files -lorespatch in APLGR/L.INC for 
low resolution graphics, and hirespatch 
in APLGR/H.INC for high resolution 
graphics. These include files also con- 
tain other procedures such as those 
needed to clear a screen, position the 
cursor, plot a point or line, choose the 
drawing color, or switch from text to 
graphics display. These other routines 
are self-explanatory, but lorespatch, 
hirespatch, and the 6502 register- 
loading routines require some ex- 
planation. 

Before a register-loading routine is 
called, the AppliCard puts the drawing 
parameters in a common data area in 
the Apple's RAM. Next, the AppliCard 
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tells the 6502 to JSR to one of the 
register-loading routines. 

The LORES.A65 file is the source for 
the routines used to load the registers 
for low resolution graphics calls. A 
similar file generated the 6502 code 
needed to set up for high resolution 
calls. The code areas used to set up the 
6502 for low and high resolution 
graphics calls are separate, so that 
parameters may be passed to both the 
low and high resolution ROM routines 
without having to rewrite the register- 
loading routines into the 6502's RAM. I 
wrote these register-loading routines in 
6502 assembly language and assembled 
them with the 6502 cross-assembler 
that was part of the PCPI OEM 
package, but any 6502 assembler could 
have been used. 

The instructions in each register- 
loading routine set up the 6502 for the 
graphics call, and then make it JSR to 
the proper graphics routine in the Ap- 
ple's ROM. These short code segments 
for passing parameters to the Apple 
ROM's low and high resolution routines 
were designed to share a common data 
area -three bytes starting at $9000. 
Data written by the AppliCard to $9000 
and $9001 are destined for the A and Y 
registers, respectively. Location $9002 
is used to hold a byte that will be loaded 
into the X register or location $2C or 
$2D, depending on which graphics 
routine is being called. 

I incorporated the hex opcodes and 
addresses from these assembly listings 
into the procedures lorespatch and 
hirespatch using a nonstandard but 
convenient feature of Turbo Pascal 
called a typed constant (the arrays 
LORESTUFF and HIRESTUFF) that 
allows variables to be initialized. Users 
of other Pascals may have to use a 
series of standard constants and 
assignment statements to enter the 
patches. 

Sample Programs 

The program LOWRES.PAS demon- 
strates how the low resolution routines 
are called from a Pascal program. The 
files PCP.INC. APLGR/G.INC, and 
APLGR/L.INC are included into the 
source to make the low resolution 
routines available. The main program 
block begins by calling lorespatch to in- 
stall the register-loading routines into 
the Apple's RAM. After printing a 
signon message, the main program 
selects and clears low resolution 
graphics page 1, and then returns to the 



TEXT mode to display the next 
message. Next it runs through the low- 
resolution colors as it draws a series of 
horizontal and then vertical lines across 
the screen. 

Low resolution graphics may be 
useful for games and pattern 
generation, but high resolution is bet- 
ter suited for plotting data. The 
program SINES. PAS draws a cycle of a 
sine wave repeatedly in different colors 
on the high resolution screen. It shows 
that the high resolution procedures are 
installed and called in a manner similar 
to that used for low resolution graphics. 

It also illustrates a crude but effec- 
tive general approach to plotting real 
world data (data in world coordinates) 
on a display screen, which is patterned 
after the more extensive SIGGRAPH 
and GKS approaches. The basic idea is 
that measurements along the real 
world X and Y axes are scaled and shif- 
ted so that points in a rectangular 
region on the X.Y plane will be mapped 
into a corresponding rectangular area 
on the display. 

The lower left and upper right cor- 
ners of the rectangular area in world 
coordinates are described by variables 
of the data type 

realdata - RECORD 

x:real; {horizontal "real world" 

coordinate} 
y:real; {vertical "real world" 
coordinate} 
END; 

The variables "lowerleft" and "up- 
perright," which are diagonally op- 
posite corners of this rectangular area, 
specify its location and size. 

The area on the display that is to 
correspond to points in this rectangle is 
described by variables of the type 

screendata = RECORD 

x:integer; {horizontal coordinate of a 

point on the display} 
y:integer; {vertical coordinate of a 
point on the display} 
END; 
This implementation emulates only a 
tiny fraction of the SIGGRAPH and 
GKS standards. Therefore I decided to 
call the area of the screen to which the 
real world data are mapped a "frame" 
rather than a "window." The variable 
"frameloc" is the position of the left up- 
per corner of the frame, and 
"framesize" is the width and height of 
the frame. 

The variables "lowerleft," "up- 
perright," "frameloc" and "framesize" 
are used to set up the X and Y scale fac- 



tors and offsets that will be needed 
later to map the world coordinates onto 
the display. Procedure "setframe" in 
PLOTTER.INC calculates these scale 
factors, which are returned in the 
variable "frame." Because these scale 
factors and offsets are calculated by a 
procedure that is different from the 
procedures that use them, the variable 
"frame" is declared in the main 
program heading so that it is global. 

PLOTTER.INC also contains two 
other procedures. The cursor is moved 
to a point on the display at a location 
that corresponds to its world coor- 
dinates, and a point is drawn there, by 
the procedure "point." To draw a line 
from the last location of the cursor to a 
specified point, the procedure 
"plotline" is used. 

The high resolution screen is easily 
dumped to a dot matrix printer with a 
program like DUMPSCRN.PAS. This 
program was written for use with a 
Grappler parallel interface card and an 
Epson MX-80 printer, but it could be 
modified to run with other interface 
cards and other printers. Alternatively, 
data could be read from the high 
resolution screen one line at a time and 
used to drive some other output device 
if necessary. If this were done, the high 
order bit of every byte should be omit- 
ted, since this bit selects color and does 
not represent a point on the screen. 

The programs SAVSCRN.PAS and 
GETSCRN.PAS perform a simple 
screen save and restore. SAVSCRN 
reads the high resolution screen one 
line at a time and writes it to disk in a 
file that occupies 8K bytes. GETSCRN 
reads such a file and writes its contents 
into the high resolution display, 
obliterating anything that was there 
before. These two programs could be 
modified for data compression, 
reducing the disk space required. 
GETSCRN could also be changed to 
allow ORing the file contents with the 
data already on the screen, so that the 
contents of several files could be 
superimposed on one another. 

Conclusions 

These routines will run as-is with the 
PCPI AppliCard on an Apple II + /He or 
Franklin (with old-style, Apple-copy 
ROMs). They should require little 
modification to run with other high 
level languages. 

Users with different Z80 boards will 
probably need to change the routines 
that communicate between the Z80 and 
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the 6502. In different CP/M implemen- 
tations, portions of the graphics 
memory may be allocated to vital 
systems routines so that writing 
anything to them may cause a crash. 
Some experimentation may be needed 
to find which of the low- and high- 
resolution screens can be safely used. 

In writing these routines, I 
deliberately chose a syntax that was 



similar to Applesoft BASIC'S graphics 
commands. The command names can be 
changed to suit any preference. 

Although these routines provide only 
a few commands, I have found them to 
be quite useful. I have incorporated 
them in programs that test random 
number generators, generate fractal 
images, and solve differential equations 
that simulate nerve signals. These 



routines could easily be expanded to in- 
clude additional commands, like 
relative cursor move and draw, and 
curve- and circle-drawing algorithms. 
In particular, PLOTTER.INC could be 
replaced by a set of procedures and 
functions that implement SIGGRAPH 
or GKS routines, such as clipping 
algorithms. ■ 



INDEX OF LISTINGS 



Fi !• 
PCP. INC 
APLGR/G. INC 

APU3R/L. IMC 

(VLGR/H. INC 

LORES. AA5 

LOHRCS.PAS 

SINES. PAS 

PLOTTER. INC 



Data tranefer between ZBfl and 65tf2 



Listing 1 



Constant*. types and routinn shared 

by Ioh- and high-resolution griphics Listing 



Register-loading routinn far low— 
(-•solution graphics 



Register-loading routines for high- 
resolution graphics 



Listing 
Listing 



6502 aaaawbly language tourci far lam- 

ramolution raqi ater-loadi ng routinn Listing 



Daeo n atrat ion of low- 
graphics functions 



Dae on strat i on of high-resolut ion 
graphics functions 



Listing < 
Listing 



Routinn for aapping 'world coordinates" 
onto the high-res display — used by 
SINES and other high-resolution 
progriai Li at i ng 



uape high-resolution scr 
•at nx printer 



to dot- 



SAVSCRN.PAS 



8ETSCRN.PAS 



Saves contents of a high-resolution 
screen in a file on disk 

Pills a high-resolution screen with 
the contents of a file produced by 
SAVSCRN 



Listing 9 
Listing 1* 

Listing 11 



LISTIH6 1. PCP. INC 



<PCP. INC contains primitive routines to t na a i nicitt between 
the PCPI 199 card (Appllcard) and the Franklin or Apple. 
Copyright 19S4 by N. T.Carnevale. 
Permission granted for nonprofit use. > 

<Include before any APL8R file. 
Variables and constants which mrw to be hidden fraat the 
user's progream start with en underscore) 

CONST 

Cports> 

hostouthu 

HOSTIN-«2a1f 
_HOSTSTAT-*4D| 
(coaaandt to transfer anre than one byte) 

ROHOBT-ll <ZB0 -> 69V2> 
I*«HOST-2l CaS#2 -> ZB»> 
Ccoejsend* for single byte transfers— 
_RDBVTE-ol 



n.f of PCPI ROB) 



(CO 



■7| 

I for 69*2 to execute a proce 



Thame three routine*) are low level -prteitiv**" that should 
probably never be called froa procedure* outside this file) 

FUNCTION recvbytelbytel tgatt a byte froa> the 63*2) 

CONST READV-*Ma 

BE8IN 

WHILE < READY AND portC HOBTSTAT]) ■ • DO I (wait til ready) 
racvoyta:-portC_«NTTINJ| (get byte) 
END I 

PROCEDURE _aendbyte(datuai:byteM (send a byte to 69*2) 



WHILE (BUSY AND portC HOBTSTAT J > <> D DO I (mit til ready) 
Dortt_HOBTOUT]:-datu*r <aend byte) 



Now th*j blocks that My ba referenced by other ortea ) 

FUNCTION _rdho»tbyte< apladdr: intaqer > : byte I 

(qet a bytt troi tha 6502* « RAM at addre«* apladdr) 

BEGIN 

imdhvti ( RDBvTE I i i«ndtrard (apladdr ) | 

rdhostbvti:* rKvbyti; Cqat data) 
END; 

PROCEDURE ,-rho«tbvte<aet addr : integer t ditualbytt) » 
Csend a byte to iddrm apladdr in the 63d2 ' * RAM) 
BEGIN 

_*andbyt*< HRBYTEt I ^Mndxor a < apl addr t 1 
sendbyte (datual I 
ENOi 

PROCEDURE rdho*tdata<*ourceaddr , destaddr .bufsize: integer) i 
(transfer* bufim bytes tram tha 65d2'» RAN to tha ZM'« RAM. 
ftr queen t » ara the ttirtinq iddrnta* o4 the uurct and 
destination, and length of the buffer area which is to 
receive the data. Call thuilv: 

r dhost dat a ( ap 1 addr , ADD** < buffer > , S12EOF <buf fer M 1 



VAR 



b: 



BEGIN 
_aendbyte<_RDHDST> | 
_*endword (sourcaaddr > 1 
_sendword (buf si la) I 
b*.»PTR<de*taddr > I 

FOR i: -buf size DOHNTO 1 DO BEGIN 
b~: - recvbytal 
b:-PTR(ORD(b)*l) 1 
END* 
ENDl 

PROCEDURE _wrhostdata (sourceaddr , deataddr , bu* si tt: integer) I 
(transfers bufsne bytes froat the ZBB's RAN to the 6Sd2'« RAN. 
Arguaante are the starting addresses of the source and 
destination, and length of the buffer area which la to 
receive the data. Call thusly: 

_wrho*tdata<ADDft(buffer> .apladdr .SIZEOF (buf fer ) M 
) 
VAR 

i : integer) 
bt'-bytei 
BEGIN 

.sendbyte < ,WRHDST> 1 
_»endword<de*teddr) I 
_aendword<buf at ze) 1 
b: -PTR(eourceaddr > i 
PCJR i:-bufaize DOHNTO 1 DO BEBIN 
_sendbyte(b*> t 
b:-PTR<ORD<b>+l> I 
ENDl 
ENS) 



RAN starting at apladdr. 



PROCEDURE _cat lapl (apladdr : inte 
(execute* routine in the 634)2' 
This routine aust and with a "return" caaaaend. 
NOTE: for locations > 32K, either uw negative integer a 
or hex constants) 
BEBIN 

_ sendbyte < _CAJLL) I 
.aendword (apl addr ) | 
ENDl 

(end of PCP. INC) 
LISTINB 2. APL8R/8. INC 



(APLBR/B. INC an an lea calling graphics routine* in 
ROMs free Turbo Pascal progrea*. 
Requires the PCPI ZM card (Rpplicard). 
Copyright 1VS4 by N. T. Carnarvale. 
Peretssion granted for nonprofit use.) 

(Include after PCP and before APLBR/L or APLBR/M) 

(contains these routines used by both hi- a Lore* 
PROCEDURE _*etpartition<part:part*ttan> I 
PROCEDURE _aelectpage>(paawjnuo:int*B)er) I 



) 



sendee*- d (data: integer > | 
rd (low byte first) to the 



TRUE: (i: integer H 

FAJ-BE: <b: array CI.. 2 J of byte) I 



a. i:-datal 
sendbyte<a.bCl J)| 
ENDl 



e<a.bC23)| 



CONST 

_BPL-4«l (• 


bytes/line of hi or 


lo re* 


d tap ley) 


(software ewi tehee 
8RF1-«CBQ*1 

fulbcrn" tcmirt 


far control of 
rlID-*Cd03l 


graphic* 


♦eotur 



rary storage for 



_UJC1X* * ***T2I 



TVPE 

per 1 1 1 i on* ( FULL aCN 
_ sc r eenawde* ( TE I T , 
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Soldering and Other Strange Tales 

First in a Series on Soldering, Unsoldering, and PC Board Repair 

by James O'Connor 



E< 



i dison discovers electron flow in a 
vacuum. Lee DeForest perfects the 
vacuum tube. Bardeen, Brattain and 
Shockley of Bell Labs invent the tran- 
sistor. Jack Kilby of Texas Instruments 
builds the first integrated circuit. Intel 
produces the microprocessor. Who first 
used solder for electronics? Does 
anyone know the name of this genius? 
All those great advances of electronics, 
literally held together by a common 
thread of solder. Would modern elec- 
tronics even be possible without 
soldering? 

Recently, I reorganized my scattered 
collection of magazines and books on 
electronics, and it took me almost 
forever since I kept reading them. A 
recurring theme was 'How to Solder' 
but as I read one article after another 
two trends became obvious. Either ar- 
ticles were very brief, basic even and 
omitted things I now know can be per- 
plexing to anyone who solders; or they 
were very technical, discussing things 
like the eutectic point (I won't even 
elaborate on this) providing in- 
teresting, but not very practical data 
for actual soldering. 

Thus a more comprehensive article 
devoted to soldering for the occasional 
kit builder is needed. It should cover all 
sorts of techniques and answer 
questions like "Whats that brown 
scrunge around all the solder joints?" 
Strikingly the most missing infor- 
mation was how to do things like un- 
soldering, or how to fix a damaged cir- 
cuit trace. Most articles seem to 
assume that everybody just starts 
soldering with perfect precision and 
never solders a part in the wrong place. 
I certainly have done that. And 
sometimes parts even fail, yet more 
reason for unsoldering them. 

So this series really developed inside 
out since it didn't seem fair to write 
about these unheard of topics without 
also describing the basic soldering 
process. Just note that we're limiting 
the scope to the problems and methods 
of soldering for electronics kit builders 
and those who occasionally need to 
repair a unit. Soldering small parts to 



printed circuit boards (PC boards), 
wires to lugs (metal loops on switches 
or terminal strips) etc. Certainly very 
familiar to many but perhaps not to all 
readers, maybe this series will provide 
the impetus for a software fanatic to 
turn into a hardware hacker, stranger 
things have happened before. 

The Theory 

This series is meant to be a little off- 
beat so let's start by talking about 
welding because that is what soldering 
is NOT. Due to some minor similarities 
some people think the two are related, 
but they are really quite different and 
it will help to realize this. In welding 
two pieces of identical or compatible 
metal are brought together and heated 
very hot, until they become molten or 
liquid, and in this state they mix 
together. After cooling, the result is a 
single piece formed by welding. A close 
analogy would be to take two ice cubes, 
let them melt a little, press them 
together and pop 'em back in the 
freezer, take them out later and there 
is one piece of ice. 

Journey now to the realm of the 
microscopic surface of a printed circuit 
board. At the level of an electron 
microscope we would see that the cir- 
cuit traces are not smooth shiny sur- 
faces, rather they are pitted and 
cratered like a giant moonscape. Most 
surfaces that appear smooth at our 
human level of experience are very 
rough at the level of individual 
molecules. Think what would happen if 
a liquid were spilled onto such a sur- 
face, it would flow into and through the 
various pores and crevices. Most com- 
mon glues are liquids, and when put on- 
to a surface they seep into it, and then 
the solvents in the glue evaporate and 
it hardens. Once hard it is stuck into the 
surface and if another surface is nearby 
the two are stuck together. This is 
precisely how wood and paper glues 
work. Long ago people discovered that 
some metals would act like glue on 
other metals if they could be made to 
flow like a liquid. How did they make 
these metals flow? They heated them!! 



The trick was to find a metal or an 
alloy of two metals that would turn 
liquid at a low temperature. Low 
enough to make the process practical 
with simple tools, and avoid the danger 
of melting the two metals to be joined. 
This is just the opposite of what you 
want when welding. There was another 
problem to be overcome, there are con- 
taminants in the form of corrosion and 
tiny particles of dirt on the surface of 
any metal. To allow the melted glue- 
metal to flow into the surface these 
must be removed. They can be scraped 
and polished off, but to get them out of 
the crevices below the top surface some 
chemical must be used. This chemical 
acts to clean away the interfering 
corrosion. 

Thus the basic scenario of 
soldering— metal-glue heated till it 
flows as a liquid over a well cleaned 
surface of another metal, remove the 
heat, the glue-metal hardens, and the 
joint is completed. 

Let's follow the steps to make a 
solder connection, such as attaching the 
lead from a resistor to a printed circuit 
board. The lead is pushed thru the hole 
in the board and is surrounded by the 
printed trace. Both appear shiny so 
there is no need to scrape or clean 
them. Apply the soldering iron for 
about three seconds, then feed in solder 
on the opposite side of the iron. If both 
the lead and the trace have been heated 
correctly, they will be hot enough to 
turn the solder to liquid. It will flow 
around them both, like any liquid it will 
wet' them. Remove the iron and keep 
everything motionless for a couple of 
seconds and the solder hardens. 

Sounds simple doesn't it. Then why 
do so many have so much trouble with 
so simple a task? There are probably 
many reasons, but if I had to chose just 
one I would chose, heat! The whole key 
to soldering is the right amount of heat 
in the right place at the right time. 
Without heat, soldering just won't 
work; with too much heat, damage oc- 
curs. Applying heat properly is really 
easy with the right tools, so lets talk 
about the tools next. 
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Soldering Tools 

There are only three really impor- 
tant rules about soldering tools: 

1. Use the right tool. 

2. Use the right tool. 

3. Use the right tool. 

To put it more succinctly, the easiest 
way to get into trouble is with the 
wrong tool. But what is the wrong tool, 
what's the right tool? To answer that 
question we're going to list some bran- 
ds and specifications but more impor- 
tantly we'll first talk about the function 
of the soldering tool, an understanding 
of which should allow us to always 
select the right tool for any task. 

Some soldering iron parts have 
descriptive names like screwdriver tip, 
chisel tip, conical tip etc. and you might 
be excused for thinking the job of the 
soldering iron is similiar to a 
screwdriver or a chisel. Not at all, the 
purpose of the soldering iron is to 
deliver heat, precisely the right amount 
in the right place. The names only 
describe the shape and not the real fun- 
ction of these parts. 

A good solder joint occurs when the 



two parts being soldered are hot 
enough to melt the solder, to make it 
liquid. Simple enough? In theory it is 
but in real practice there are some 
problems and the right soldering iron 
solves those problems, the wrong one 
causes them. 

Consider again the simple task of 
soldering a resistor onto a printed cir- 
cuit board. All we have to do is to heat 
both thee resistor lead and circuit trace 
to about 750 degress Fahrenheit right 
where they abut each other, apply some 
solder and let it cool. First problem; 
both the resistor lead and trace being 
made of metal are good conductors of 
heat. When the soldering iron is applied 
to the junction both will heat up and at 
the same time the heat will start 
flowing away thru both. 

If the soldering iron is too small then 
the amount of heat flowing away will 
prevent the joint from getting hot 
enough. Even worse the joint may 
eventually heat up enough but by then 
the resistor body has absorbed a great 
deal of heat and due to that may change 
value, the circuit trace may also have 
absorbed too much heat and 
delaminated (lifted off the board). So, 



we may make the solder connection 
while destroying the resistor and 
damaging the trace. And do you know 
what that means? We will have to un- 
solder the whole thing, repair the 
board, get a new resistor and try again. 
The follow-on parts of this series will 
discuss those topics, unsoldering and 
circuit board repair, because soldering 
is part knowledge and part art so even 
the best soldering artist may need to 
make such repairs. 

Many newcomers to soldering are 
rightly fearful of the damaging effects 
of heat so they tend to chose the 
smallest soldering iron available, unfor- 
tunately as we've seen this can cause 
damage. The real 'trick' is to over- 
whelm the the joint with enough heat 
that it quickly reaches the required 
temperature, make the connection, 
remove the iron and let the heat 
dissipate. 

It would seem that you should use 
the biggest soldering iron available, 
and occasionally I have observed some 
very skilled, experienced technicians 
use an oversized tool to make a connec- 
tion but they only did so lacking a more 
appropriate tool. Circuit boards can be 
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crowded places, with very fine closely 
spaced traces, an oversize tool can 
cause a problem called 'bridging' which 
is accidently joining two parts when 
they aren't supposed to be. Plus ultra 
precise timing is needed since too large 
a tool can supply heat too fast. 

Look at almost any selection of 
soldering irons, in a store or catalog, 
and you'll notice the great variety. In- 
deed, some large catalogs are devoted 
entirely to soldering irons and ac- 
cessories, and many have several pages 
df tools. We won't delve into all this 
since these are all instances of 
soldering tools for a specific job in in- 
dustry such as soldering very small 
items, or very large etc. For simple kit 
building, all you really need is a basic 
soldering iron preferably with inter- 
changeable tips. 

Soldering irons are rated in watts, 
the more watts the more heat the iron 
can supply. They all reach a tem- 
perature between 700 to 800 degrees 
Fahrenheit. Thus the wattage is not 
related to temperature, but really to 
the physical size of the parts to be 
soldered. For very small parts there 
are 12 watt irons, for most circuit board 
work there are 25 and 30 watt irons, for 
circuit boards with large wide traces 
and for large switch lugs and terminal 
strips there are 40 and 60 watt irons. 

Let's digress for just a moment. With 
basic soldering irons you control the ac- 
tual temperature of the joint by how 
long you apply the iron to it, this is a 
matter of acquired experience. It's easy 
to learn and the solder itself acts as a 
temperature gauge. For industrial 
work there are soldering stations that 
self-regulate their temperature. These 
are more elaborate and expensive, 
they're fine if you'll be doing frequent 
soldering and are very convenient but 
hardly necessary for kit building. 

For most circuit board and wire to 
lug soldering, a 25 to 30 watt soldering 
iron is just right. If you don't have such 
an iron then get one. It will pay for it- 
self even if you use it to build just one 
kit, and the entire package should cost 
less than $25 dollars. There are literally 
dozens of suitable irons availble so if we 
don't mention some chalk it up to lack 
of space. The most inexpensive type of 
iron would be the Radio Shack #64-2067 
which is a 30 watt pencil type iron, list 
price is only $3.49. This a good tool ex- 
cept that the tip is built in, that is you 
can't change it and once it wears out 
you replace the whole iron. Some tips 



cost more than this iron, for one kit this 
tool will do an adequate job. 

Radio Shack also sells two packages 
that include a 30 watt soldering iron, 
#64-2802 includes soldering accessories 
only and sells for $4.95 while #64-2801 
which sells for $14.95 also includes a 
diagonal cutter, needle-nose pliers, and 
three screwdrivers. If you don't have 
any pliers the 2801 package is a good 
choice, while the smaller 2802 package 
is not my first choice. I think you would 
do better to purchase those items in- 
dividually, you'll be able to chose better 
items and buy them in bulk. 

Next up the scale would be Radio 
Shack #64-2070, a 25 watt model with a 
replaceable tip, but there is only one 
style and size of tip, list price $5.49, tips 
are $1.29. There is also a gun handle 
model #64-2065, list price $3.99, tips 
$.89. Most people find the straight iron 
type easier to control but a few prefer 
the gun style, the choice is up to you. 
Moving up, Radio Shack also sells 
model #64-2055 which features a switch 
to select either 15 or 30 watts, list price 
$6.95, tips are $.89 but again only one 
style is available. 

Top of the line is the modular unit, 
This consists of a handle #64-2080, list 
price $4.99, to which you add a heating 
element in this case the 27 watt unit 
#64-2081, price $4.79, and a set of tips 
such as #64-2084, price $3.69. These are 
three different style of tips, broad, 
medium, and fine point. Grand total 
cost, $13.47. 

We've skipped the Radio Shack 42 
Watt iron as that is too much wattage 
for most kit building. The 75-Watt 
Soldering Gun #64-2191, is also too 
powerful. It's a different device 
because it heats its tip by sending low 
voltage current through it. Resistance 
to the current flow causes it to heat up 
just like the element in a light bulb. 
These gun type tools are very good for 
heavy soldering tasks especially since 
they heat up almost instantly and you 
might want to have one if you plan to 
really get involved in soldering. The 
torch type tools in the Radio Shack 
catalog are not suited to any electronics 
assembly that I know of. 

What about other manufacturers? 
There are at least two that deserve 
mention, but you'll have to scout up 
sources for their products. The tool I 
use is a Weller WP25 soldering iron (25- 
Watts, of course) which costs about 
$17.00, 1 paid less but then I have had it 
for over ten years now. This unit can be 



used with eight different style tips, my 
favorites are the so-called screwdriver 
tips, these are really more oval shaped 
with smoothly rounded edges. Not good 
for driving screws at all, but great for 
soldering as the rounded shape easily 
butts up against the lead and circuit 
trace while still allowing a channel for 
the solder to flow around the joint. The 
three I employ are the ST1 a 1/16" tip, 
the ST2 3/32" and the ST3 1/8", these 
cost about $3.00 each. The ST2 is used 
for almost 90% of my work, switching 
to the ST1 for very small work or the 
ST3 for larger items. 

Heathkit sells a package of tools 
(Model GGP-1270) for kit builders that 
includes the Weller WP25, it sells for 
$39.95 and again if you don't have any 
tools this is a quality assortment to 
begin with. They also sell the WP25 
seperately as Model GDP-207A, price 
$14.95. But they don't offer the inter- 
changeable tips thru their catalog. 

The other big name is Ungar. They 
have a very extensive line of soldering 
irons and tips, in fact so extensive that 
I think the hardest task is selecting the 
right tool from the variety. Ungar of- 
fers a Hobbyist iron Model CM-25 for 
about $8.00 that is a simple inexpensive 
unit. Then they have the Modular 
Standard Line wich includes a handle 
such as the 777 or 776 both about $7.00. 
These handles accept heaters in either 
the Ungar S or HP series. One type 
such as the 533-S, 536-S, or 539-S in- 
cludes both heater and tip, for about 
$9.00 each. While the 537-S, cost about 
$8.00, accepts thread-on tips such as the 
PL-151 screwdriver tip which cost 
about $3.00. And there are even more 
available, including some special ac- 
cessories. At the end of this article I list 
some sources for catalogs that include 
both the Weller and Ungar line, you 
may wish to obtain these catalogs just 
to see the great variety of soldering 
tools available. 

The Radio Shack Modular line and 
the Ungar Modular are so similiar that 
it is fair to conjecture that Ungar 
makes the Radio Shack units but this 
doesn't guarantee compatability bet- 
ween the various accessories. 

We'll need one more item to com- 
plete the package and that is the most 
important of all, a suitable stand for the 
iron. Why is it so vital? Because it 
provides safety. Hot soldering irons can 
burn people, char things, melt them, set 
some things afire, and just plain wreck 
havoc. The soldering iron holder over- 
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comes most of these dangers. You'll 
still need to exercise care when using a 
hot iron but it's much safer with a 
holder. Some kits come with a holder 
that consists of a bent piece of wire on a 
small plastic disc, these are still better 
than nothing at all but just barely. Do 
purchase a real holder, Radio Shack 
#64-2079 is a satisfactory unit, list price 
$5.79. The Weller PH25 cost about 
$8.00 or PH60 cost about $10.00 are also 
good. Don't fail to buy a holder because 
of the cost, it's worth it, you'll save the 
price if it prevents just one accident. 

There are only two things to keep in 
mind when selecting a holder, first be 
sure that your iron fits the holder, some 
units are made for specific irons and 
won't hold other brands or types. For 
instance, Ungar makes one holder for 
their Standard irons and another for 
the Princess irons. Secondly, some 
holders are made to be free standing 
while others work best only if screwed 
to the workbench, just be sure to get 
the type that fits your situation. 

The holder will include a sponge, use 
this to keep the iron properly 'tinned'. 
When you first heat the iron, stroke it 
across the dampened sponge on each 
edge and then melt just enough solder 
onto the tip to coat it. As you work, 
heat will cause a layer of 'crud' to build 
up on the tip, this stuff is an insulator 
that can block heat transfer. Clean it off 
by stroking the tip over the sponge, if 
the tip comes away with a bluish color, 
re-tin it with solder to keep it working 
at maximum efficiency. 

One final precautionary hint — none 
of the irons we've mentioned glow 
when hot, nor do they have any in- 
dicating lights to show that they are on. 
This can be a real hazard since you may 
go off and leave the iron on, if you have 
a stand this won't hurt anything but 
your electric bill (no worse than leaving 
a 25- Watt bulb on). Without a stand this 
can cause a fire, yet more reason for 
having a stand. A good idea is to use 
one of those barrier type outlets with a 
built in power-on light, with this you 
can always be sure that everything is 
off when you finish. 

To summarize, all you'll need is a 25 
or 30- Watt soldering iron, ideally with 
changeable tips, and a good holder for it 
and you're all set for 99% of all the 
soldering required for most kits. 

Using The Tool 

If you do get one with changeable 
tips, then how to do you select the right 



tip for a given task? It's really quite 
simple but it does involve a little 
judgement. Take a look at the circuit 
board you'll be working on, estimate 
the average size of the circuit pads 
where the joints will be, and chose a tip 
that is approximately 60 to 80% as 
wide as an average sized pad. This is all 
very approximate, precise measurmen- 
ts are not required. Try to avoid using a 
tip that is wider than most pads as that 
can induce bridging. 

Of course some pads may be much 
smaller while others are much larger, 
this is where you need to switch tips 
especially for the larger ones. Pads that 
connect to the ground plane of a circuit 
board are often very large, indeed they 
may blend into wide expanses of trace. 
These 'big game' pads often gather in 
the vicinty of the electronic equivalent 
of a waterhole, namely voltage 
regulators. The sheer size of them 
draws away heat too quickly, thus swit- 
ching to a larger tip can make the dif- 
ference when soldering these big pads. 

This leads to a pet peeve of mine, 
most kit instructions blithely ignore 
the problems that occur when soldering 
different size items. That is the instruc- 
tions will often have you solder things 
following some pattern totally 
unrelated to the requirements of 
soldering, such as working in only one 
area. This is one instance where it may 
be wise to skip some steps because you 
can see that you have the wrong size tip 
on your iron. Just be sure to mark the 
steps you've skiped so that later you 
can go back and re-do them. 

Instructions that have you install 
things by size, that is starting with the 
smaller items and ending with the 
larger ones are usually just fine for 
soldering, start with a small tip if 
needed, switch to a medium size, ending 
with the large size. Do be methodical, 
as this type of instruction predisposes 
you to installing parts in the wrong 
location or forgeting a part. Perhaps in 
a future article we can discuss the fine 
art of interpreting instructions. 

Flux 

What an odd sounding word, look it 
up in the dictionary and you find that it 
means: flow, state of change, a 
discharge of liquid, and an aid to 
soldering. The other meanings are 
rarely used anymore, so clearly we are 
interested in its association with 
soldering. 

Let's start at the beginning. The first 




NGS FORTH 

A FAST FORTH, 
OPTIMIZED FOR THE IBM 
PERSONAL COMPUTER AND 
MS-DOS COMPATIBLES. 



STANDARD FEATURES 
. INCLUDE; 

•79 STANDARD 

•DIRECT I/O ACCESS 

•FULL ACCESS TO MS-DOS 
FILES AND FUNCTIONS 

•ENVIRONMENT SAVE 
& LOAD 

•MULTT -SEGMENTED FOR 
LARGE APPLICATIONS 

•EXTENDED ADDRESSING 

•MEMORY ALLOCATION 
CONFIGURABLE ON-LINE 

•AUTO LOAD SCREEN BOOT 

•LINE & SCREEN EDITORS 

•DECOMPILER AND 
DEBUGGING AIDS 

•8088 ASSEMBLER 

•GRAPHICS & SOUND 

•NGS ENHANCEMENTS 

•DETAILED MANUAL 

•INEXPENSIVE UPGRADES 

•NGS USER NEWSLETTER 

A COMPLETE FORTH 
DEVELOPMENT SYSTEM. 

PRICES START AT $70~ 

NEW<*>HP-150 ft HP-110 
VERSIONS AVAILABLE 




NEXT GENERATION SYSTEMS 
P.O.BOX a»§7 
SANTA CLARA, CA. 95055 
(400) 241-5909 



18 



The Computer Journal/Issue #20 



people to solder must have used 
something as a flux but didn't call it 
that, we don't know if they called it 
anything. Eventually some onlooker 
must have asked "What do you call that 
■ stuff?" and the ancient solderer may 
have mumbled, "I call it the stuff that 
helps me to solder, it changes the 
metals so they bond." Immediately, 
they went to their Funk & Wagnalls or 
whatever they had then and looked for 
a word that meant change, or helps to 
change, preferably a catchy little four 
letter word, and lo they found 'flux'. 

So flux helps change the metals, but 
what does it change? One property of 
metals is that they tarnish and corrode. 
Some more rapidly and obviously than 
others but they all do it. Corrosion is 
the tendancy of metals to combine with 
oxygen which forms a metallic oxide, 
steel is the prime culprit — there is even 
a word to describe the process, rust. 
Steel corrodes quite slowly and the 
resulting oxide, rust is crumbly and un- 
stable. Most other metals corrode so 
rapidly that the resulting oxide forms a 
skin or coating that seals off the surface 
of the metal preventing further 
corrosion. Zinc does this which is why 
steel is often coated with zinc, in order 
to protect the steel, in the process 
called galvanizing. Copper, nickel and 
other metals used on leads and traces 
also tarnish and corrode and that can 
block the molten solder from bonding to 
them. 

One way to clean the metal would be 
to sand it, plumbers do this when 
soldering copper pipe. The sanding 
breaks the surface coating but more 
tarnish extends down into the metal 
and this must be removed by some 
chemical action that can flow into the 
minute pores of the surface. The plum- 
ber uses a mild acid mixture to accom- 
plish this. 

Electronics technicians could also use 
acid, and in the early days actually did, 
but the acid remains after soldering 
and can continue to eat away at the 
metal. The pipes that a plumber solders 
are massive enough that only a minute 
amount of metal is destroyed before the 
acid is used up, but electronic joints are 
tiny in comparison. Early users of acid 
fluxes for electronic work soon 
discovered that the connections would 
fail after a few months, literally eaten 
away by the residue of acid flux. This is 
why there are so many dire warnings 
about using acid fluxes for building kits 
or any other electronic work. It is also 



why you shouldn't buy flux at a har- 
dware store. They carry flux meant for 
plumbing work and the salespeople of- 
ten don't know that such fluxes should 
never be used for electronics. 

So what can be used for electronics, 
clearly early users had to find 
something other than acid. They found 
the right product in the form of rosin. 
Rosin (sometimes also spelled resin) is a 
material that occurs in pine trees and is 
obtained along with the distillation of 
turpentine. It is virtually inert, that is 
harmless to most substances when 
solid, but when heated it becomes a 
liquid solvent. In its liquid state it does 
a fairly good job of dissolving the tar- 
nish layer on metals used in electronics. 
Rosin is easy to work with, early users 
ground it into a powder and applied it 
prior to soldering, combining it with 
some liquid solvent to form a paste. 
This worked fine but then someone had 
the idea of combining solder and rosin, 
they developed a way of extruding the 
solder as a hollow wire with the rosin 
inside, what is today called rosin-core 
solder'. Purchase solder at an elec- 
tronics store and you can't help but ob- 
tain flux in this, its most convenient 
form. 

If this were any old article about 
soldering and fluxes this would be the 
end of the story but there is more, even 
a minor mystery of sorts, that is still to 
come. 

As you use rosin-core solder it melts 
and part of the rosin also melts flowing 
out to clean away the tarnish. Some of 
the rosin also goes up in a little puff of 
smoke. Nowhere in any tutorial have I 
ever seen the smoke mentioned, 
needless to say many a first time 
solderer has been puzzled and even 
alarmed by this phenomena, after all 
smoke is associated with fire and bur- 
ning. The smoke is supposedly har- 
mless, at least I don't know of any 
studies indicating that is an oc- 
cupational hazard. I do know that many 
people, myself included, find it an 
irritant to the eyes and nose. Invariably 
just when you're straining to see what 
you're doing, the smoke makes you 
want to sneeze. This effect seems to 
wear off quickly and everyone is affec- 
ted differently, so if soldering makes 
you sneeze perhaps now you know that 
it's really the 'flux'. 

What about the rosin that doesn't go 
up in smoke? It usually forms a coating 
around the completed solder joint. 
When still molten it will be clear in 



color and as it quickly hardens (one or 
two seconds) turns a brownish shade. 
Here comes yet another pet peeve of 
mine. In any tutorial on soldering there 
always appears the picture of the ideal 
solder joint, AFTER the rosin has been 
cleaned away. The trouble is that with 
rosin core solder, you always get excess 
flux on the joint which will partly ob- 
scure it. The experienced solderer 
learns to peer through this coating to 
check the joint, but the newcomer is of- 
ten confounded by the appearance of 
what is probably a perfectly good con- 
nection. Later we'll talk about cleaning 
away flux and you can do this to verify 
that a solder joint is good or bad until 
such time as you can tell from ex- 
perience. 

There is yet one more phenomena 
that occurs. When the flux melts it also 
tends to bubble like any hot liquid, 
these bubbles will literally pop out of 
the joint and land anywhere from a 
quarter inch to a half inch away where 
they then harden. This same thing hap- 
pens in welding, except that the bub- 
bling liquid is molten metal as are the 
solidifed bubbles. Again many novice 
solderers may think the rosin bubbles 
are soldified solder, they can look very 
metallic and do pop out of the solder 
joint. Just poke these bubbles and 
you'll find that they crumble into dust. 

By now experienced readers may 
think we've exhasuted everything 
there is to say about flux, but wait 
remember we promised a mystery, 
here it is. 

Rosin is considered inert, that is it 
doesn't corrode anything and won't 
conduct electricity, and for a long time 
everyone seemed to agree on this. In- 
structions with any electronic kit never 
mentioned any potential problems with 
the rosin left on the circuit boards — in- 
deed they rarely mentioned it all. But 
then a few years ago articles began to 
appear that instructed us to clean away 
the flux after the soldering was com- 
pletely finished. Indeed some of these 
warned of dire results if the flux was 
not fully purged from the board. 

As a firm believer in following in- 
structions, I like many others dutifully 
complied. And then I discovered 
something never mentioned in the in- 
structions (so what's new), it's really 
hard to clean away rosin flux. You need 
to use strong vaporous solvent to 
disolve the stuff and flush it away. 
Some of these solvents can damage the 
parts mounted on the board. Parts that 
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have plastic are very susceptible, relay 
housings, connectors etc., and since you 
have to invert the board to clean it you 
can't prevent the solvent from reaching 
such parts. Rosin is also very sticky 
when it is dissolved, recall that it is also 
called resin. You have to flush the 
board in solvent several times to 
remove most of the flux, and even then 
there is a thin sticky residue left 
behind. 

The mystery arises because not all 
kit makers recommended this step, 
examining circuit boards in commercial 
products also showed some that had 
been cleaned others not. Who's right 
and why had supposedly harmless inert 
flux suddenly turned into an insidious 
destroyer of circuits? Gradually, I 
pieced together a possible explanation. 
I have no way of knowing if it is factual 
but I will present the hypothesis and 
you can be the judge. 

Soldering by hand is a labor intensive 
step, American electronics makers in 
an effort to compete with the low cost 
labor of the Far East have long sought 
to eliminate it. Two ways to do this are 
dip soldering or wave soldering. In 
these two techniques all the parts are 
simply mounted (stuffed is the technical 
term, and yes it is inelegant) on a board 
which is then conveyed to a large 
heated tank containing molten solder. 
Dip soldering is just what the name im- 
plies, the lower surface of the board is 
dipped into the solder, in wave 
soldering the board is suspended just 
above the surface of the tank while a 
wave is formed in the solder which 
sweeps past the bottom of the board. 
Both methods allow all the connections 
to be made in one step. 

In either of these techniques flux 
must be used, but obviously rosin core 
is impractical. In fact rosin isn't quite 
up to the job, since it has to melt it 
couldn't work fast enough to 
thoroughly clean. So in wave or dip 
soldering the flux is applied just before 
the soldering station (the whole process 
is usually automated) and is an mild 
acid flux. 

To recap, the boards are stuffed with 
parts, they move to a station where an 
acidic flux is applied, then to a wave 
soldering tank. Guess what has to come 
next? If you guessed a station where 
any remaining flux is cleaned off you're 
right. This flux has to be cleaned off 
because of it's corrosivness. And the 
final station on the line, why a visual in- 
spection station, yet another good 
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reason for cleaning the flux away. 

My feeling is that some people 
familiar with how boards are soldered 
and then cleaned in an automated 
production facility incorrectly exten- 
ded that to what happens when boards 
are hand soldered using good ole har- 
mless rosin-core solder. You can verify 
this hypothesis by the fact that most 
circuit boards from America are indeed 
well cleaned while boards in products 
madain the Far East rarely are 
(although this is changing as 
automation is spreading throughout the 
world.) 

The bottom line is that if you use 
rosin-core solder then you really don't 



have to clean it all away. You can do so 
if you wish for aesthetic reasons or to 
inspect the connections. 

One more comment about flux 
removal. If you purchase finished 
products under warranty you will 
probably be warned that the warranty 
is void if repairs or alterations are 
made. Let's assume that you wish to 
alter or repair the item and that you 
can open it up without breaking any 
seals or leaving other telltale clues as 
to what you've done. If you do any 
soldering then you should either clean 
away any flux if the board is otherwise 
Quxless or be sure not to if that is its 
original condition. Otherwise should 
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you return the item for a warranty 
repair then flux or lack thereof may 
give you away. 

The corollary is that if you ever need 
to repair or inspect a circuit board, the 
presence of flux on a clean board in- 
variably indicates some sort of repair 
or rework occurred. Many times the 
parts replaced will have failed again 
and this will give you a clue as to what 
needs fixing. You should also inspect 
the joints to be sure the previous 
technician properly soldered them, 
sometimes that's the problem. 
Soldering failures are the very reason 
for this article. 

It wouldn't be fair to spend so much 
time talking about removing flux 
without discussing how to do so. Let's 
imagine that you want to clean an en- 
tire board and that you're sure there 
are no parts on the board that could be 
damaged by cleaning it, such as swit- 
ches, relays etc. You'll need a solvent. 
You can purchase spray cans 
specifically labeled for removing rosin 
based flux. You can also use some com- 
mon solvents such as Isopropyl 
Alchohol or VMP Naptha, both can 
damage plastics so don't use these if 
there are vulnerable parts. Don't use 



paint thinner as most leave some 
residues after evaporating. And never, 
NEVER use gasoline or kerosene, both 
are far too dangerous to ever use as a 
cleaner or solvent and that which 
makes them so hazardous also makes 
them do a lousy job. 

Next you'll need a safe place to work, 
even the recommended solvents all 
produce vapors that must be ven- 
tilated. Don't work near any flames, 
open or closed, or anything that can 
spark, or make sure such things are 
turned off while you work and until the 
fumes have been expelled. Label any 
switches so that no one can accidentally 
turn them on, while you're working. 

You will also need a place to work 
where the liquid solvent and flux can 
NOT cause physical damage. Don't 
work above a fine piece of furniture, a 
finished floor, or wall-to-wall carpet. All 
of these solvents can disolve finishes, 
leave white streaks, and the rosin can 
stain fabrics. And some of them, the 
one that Radio Shack sells for example, 
will really do a number on plastics. In 
fact the Radio Shack brand will mar 
plastics even if just the overspray hits 
them, so work well away from in- 
struments or other objects in plastic 



cases. 

Spray the solvent onto the board 
while holding it at a slight incline, work 
from top to bottom so the dissolved flux 
flows away from the board. If the flux is 
particulary stubborn use a retired 
toothbrush (test first to be sure the 
solvent won't disolve it) scrubbing 
around the connections to encourage 
the cleaning action. 

To clean one or two connections, such 
as after a repair, the following 
technique is easier and safer. Take a 
cotton swab, hold it right up to the 
spray nozzle, and spritz it just enough 
to wet it. Roll the swab around the 
joint, don't scrub as the sharp edges 
will catch and tear it up. The cotton will 
absorb the flux and leave a neat looking 
repair. You may need to do it several 
times for maximum cleaning. By the 
way the Radio Shack product is great 
for this job, just be sure that when wet- 
ting the cotton tip that any overspray 
will not touch plastic surfaces. 

Solder 

Electronics solder is an alloy of 60% 
tin and 40% lead. These proportions 

(continued on page 27) 
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Build a S-100 Floppy Disk Controller Board 

WD2797 controller for CP/M 68K 

by Joseph Kohler 



J\ ny discussion of a floppy disk controller board which 
ignores the software to run the controller is incomplete. The 
board described in this article is presently being used with 
the 68008 CPU card given in reference 3 so all software will 
be for the 68008. The controller may be used with any S-100 
CPU card provided the CPU chip is fast enough to perform 
the time critical functions of the routines mrd and mwr 
discused later. 

If you wish to run CP/M 68K or any other operating system 
you will need a floppy disk controller board and a boot rom. 
Here is a design using the WD2797 which operates both 5 and 
8 inch drives in single and double density. 

Hardware 

Addressing: A 8131 (see Figure 1) is used together with dip 
switches and pullup resistors to select 8 addressess in the I/O 
space to which the board will respond. Assertion of MATCH- 
H, SOUT and PWR results in assertion of PUT-H and PUT-L 
(see Figure 2). Writes to the board with A2 set to access the 
WD2797 (see Figure 3) and with A2 set to 1 they access the 
control latch (see Figure 2). Assertion of MATCH-H, SINP 
and PDBIN results in the assertion of GET-H and GET-L (see 
Figure 2). Reads from the board with A2 set toO access the 
WD2797 (see Figure 3) and with A2 set to 1 they access the 
wait flip-flop (see Figure 4). 

Clock: A 4MHZ clock (see Figure 1) is divided by 2 and 4 
using two flip-flops to produce clocks of 2MHZ and 1MHZ for 
use by the WD2797. Bit 5 of the control latch determines 
whether a 1MHZ or 2MHZ clock reaches the WD2797. This 
choice is made by using two tristate drivers of an LS125 (see 
Figure 4) and enabling one or the other to pass either the 
1MHZ or 2MHZ signal to the WD2797. The WD2797 requires 
the 1MHZ for 5 inch drives and the 2MHZ clock for 8 inch 
drives. 

Control latch: Overall control of the board resides in an 
LS273 8 bit latch. The meanings of the various bits are shown 
in Table 1. 

This design simplifies the hardware at a slight cost in sof- 
tware complexity. A byte must be kept in ram which reflects 
the state of the LS273, since the LS273 is write only. In order 
to make a change you must get the ram copy, change only the 
desired bits in the ram copy and then write it to the LS273. 

When RESET or POC is asserted so is MCLR-L, which 
initializes the LS273 so that no drive is selected and MOTOR- 
ON-Lis negated. The EPROM is enabled and PHANTOM is 
asserted on the S-100 bus (provided the switches to use the 
EPROM and PHANTOM are on). 

Wait flip-flop: The read which references the wait flip-flop 
is simply used to create a pulse which clocks the wait flip-flop, 
with no intent to return data to the CPU. Assertion of POC or 
RESET clears the wait flip-flop. 

My first exposure to the idea of stalling the CPU was in an 
early issue of BYTE (see reference 1) where a USRT was em- 
ployed to serve as a floppy disk controller. The wait flip-flop is 



just a device to synchronize data transfers between the CPU 
the and WD2797. 

INTRQ: If an error occurs during data transfers between 
the CPU and disk the WD2797 asserts INTRQ. Furthermore. 
INTRQ once asserted remains asserted until the WD2797 
status is read. As long as INTRQ is asserted the wait flip-flop 
is held in a clear state no matter what happens at its clock in- 
put. Thus in case of error the routines mrd and mwr run to 
completion (transferring meaningless data) without wait 
states. INTRQ is negated by the routine mbusy when the 
status is read (see Figures 3 and 4). 
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Figure 1: Clock and base port selection. 
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Figure 2: Control latch and decoding for 
CNTRL-CK and WAIT-CK. 
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Figure 3: WD2797 data and control. 
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Figure 4: Clock selection and wait sync circuit. 



bit alow selects 8 inch drive 

bit 1 a low selects 8 inch drive 1 

bit 2 a low selects 5 inch drive 

bit 3 a low selects 5 inch drive 1 

At most one of the above bits should 
be low at the same time. 

bit 4 a low (high) selects double (single) density 

bit 5 a low (high) enables the 1MHz (2MHz) 

clock and the buffers to operate 

5 (8) inch drives 
bit 6 a low (high) enables (disables) the 

EPROM and the PHANTOM 
bit 7 a low (high) negates (asserts) the 5 inch 

motor on signal 

Table 1 



DRQ: Whenever the WD2797 wants to transfer a byte of 
data it asserts DRQ which clears the wait flip-flop waking up 
the CPU. Details may be found in the discussion of the 
routines mrd and mwr (see Figures 3 and 4). 

Drive interface: The interface between drives and the 
WD2797 follows a well defined standard. The rules are that 
signals received are pulled up by a 150 ohm resistor, and 
signals sent must be driven by something capable of pulling a 
line (which is pulled up by a 150 ohm resistor) low. An LS244 
or LS240 meets this requirement. There is also enough 
hystersis to reliably receive the raw read data. 

Bit 5 of the control latch is used to select the LS240 and 
LS244 (see Figures 6, 7 and 8) drivers and receivers for 
whichever type of drive is being read or written. The two 
signals which do the selection are EN5-L for 5 inch and EN8-L 
for 8 inch drives. Note EN8-L is the inversion EN5-L (see 
Figure 4) so exactly one of these signals is active at any time. 
EPROM: Reads from the EPROM occur when PROM-SEL- 
L is asserted by the control latch, A15 is and SMEMR is 
asserted (see Figure 12). In order to transfer ROM data to the 
CPU the dip switch E3, which connects pin 10 to pin 7 must be 
closed (see Figure 11), otherwise the OE pin of the EPROM 
(see Figure 11 and 12) will be pulled high by a pullup resistor 
and BOARD-TO BUS-L will not be asserted. If dip switch E3, 
which connects pin 11 to pin 6 is closed and the control latch 
asserts PROM-SEL-L then PHANTOM is asserted. 

The EPROM socket has 28 pins so any EPROM from a 2716 
to a 27128 can be used. So far a 2716 has proved adequate sin- 
ce it is used only to boot CP/M 68K. NOTE: The pin numbers 
in Figure 12 refer to the 28 pin socket. 

The program in the present EPROM simply moves a loader 
program to RAM (beginning at $9000) and then jumps to 
$9000 to execute the loader. My present system uses two 
Digital Research 64K RAM cards. The low order board is set 
with half phantom and the high order with full phantom 
enabled. If more boards are added they should have full phan- 
tom enabled. 

Adjustment procedure: The WD2797 requires some initial 
adjustments in order to operate. 

1. Make sure switches E3 pin 6, 7 and 8 are all open. If you 
want to be more careful also remove the EPROM. 

2. Do not connect cables to disk drives. 

3. Place the board in an S-100 system with power off. Turn 
on power. 

4. Press reset to force control latch outputs DEN-SEL and 
EN5-L low, which sets the DDEN input to the WD2797 low 
and the 5/8 input to 5 inch. 

5. Momentarily short pins 19 and 20 to perform a master 
reset on the WD2797. 

6. Close switch E3 pin 8 to enable TEST on the WD2797. 

7. Set your scope to O.lus/div and place probe on pin 31 of 
the WD2797. Adjust the 10K pot until you see a waveform 
200ns wide. 

8. Now put your probe on pin 29 of the WD2797. Adjust the 
50K pot until you see a waveform 250ns wide. 

9. Set your scope to lus/div and adjust the 5-60pf variable 
capacitor until you see a squarewave with pulse width 2us i.e. 
a frequency of 250KHZ. 

10. Open switch E3 pin 8 to disable TEST on the WD2797. 
For more information on the WD2797 see reference 2. 
The discussion below assumes a5 points to the base port of 

the controller board. For example, if the address selection 
switches are all on the base port is 0. so a5 must be set to $ff- 
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ffOO. Also the equates 



status 
fcmd 



equ 
equ 



are in effect. 

Execution of a read: The instruction 

move.b status(a5),dl 

reads the status register of the WD2797. The 68008 CPU 
board executes this instruction by placing the address SffffOO 
on address lines A0 through A23 (see Figure 9 ). Address 
signals A3 through A7 are passed through El to E2, an 8131, 
which then asserts MATCH-H because BA3 through BA7 are 
all low (see Figure 1). Next the 68008 CPU board asserts 
SINP and PDBIN. The WD2797 board receives these signals 
through (the always enabled LS244) D2 so BIN-H and BDIN-H 
are asserted on the board. Now pins 3, 4 and 5 of A2 (see 
Figure 2) are all high so GET-L is asserted. This forces the 
assertion of GET-H which in turn results in the assertion of 
BOARD-TO-BUS-L. Now the WD2797 has a low on CS 
because A2 is and a low on RE since GET-L is asserted. The 
lines A0 and Al now select the register within the WD2797 
whose contents will be sent to its DAL lines and therefore 
appear as data on BDO through BD7. Finally, the data appears 
on the S-100 bus through the enabled driver C2 (see Figure 9). 

Execution of a write: The instruction 

move.b d4,fcmd(a5) 

sends a command to the WD2797. 

The address information and the assertion of MATCH-H is 
the same for read and write. After the address information is 
setup the 68008 CPU board asserts SOUT and places d4.b on 
DO0 through D07. Following a suitable delay the 68008 CPU 
board asserts PWR. The WD2797 board receives PWR and 
SOUT through D2 (see Figure 10) so BWR-H and BOUT-H are 
asserted. Now pins 1, 2 and 13 of A2 (see Figure 2) are all high 
so PUT-L is asserted. This in turn enables the buffer CI (see 
Figure 9) so the data on DO0 through D07 arrives on BDO 
through BD7. Now the WD2797 has a low on CS because A2 is 
and low on WE since PUT-L is asserted. The lines A0 and 
Al now select the register within the WD2797 to which the 
data on its DAL inputs will be sent. 

Software 

The CP/M 68K BIOS is too long to fit into this article but 
you can follow the code to read and write sectors by assuming 
that a4 points to a RAM buffer, d6.w has the track number 
and d7.w has the sector number of the host disk. 

The software discussion below is for 5 inch drives, but is 
almost identical for 8 inch drives, mdriv is the only routine 
which is different and it is simpler for the 8 inch drives. 
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Figure 5: WD2797 set up circuits. 
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Figure 7: More 5 and 8 inch drive control. 
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Figure 8 : Eight inch drive control. 



The details of the err routine, which just prints, are omit- 
ted. 

rd mini: At entrance to rd mini register sp is saved so 

that in case an error occurs during processing the error 
routine can restore sp. This relieves the other routines of the 

burden of keeping track of sp. Upon return from rw mini 

d4.w has the SSO bit set and all other bits are 0. The WD2797 



read command is or'ed into d4.w and the command placed into 
dl.w for use by mrd, which returns, after executing the r -ad, 
with the WD2797 status in dl.w. The relavent bits are 
checked for a read error. If a read error has occurred bit 6 of 
erflag is set. The final return is then made to read. 

rwmini: The routine parmx merely sets a5 to point to the 
base port of the board and sets d5.w to the disk unit number. 
Each cylinder is divided into 2 tracks i.e. cylinder n of a 
diskette consists of tracks 2n and 2n. The track number is 
converted into a cylinder number, placed in d6.w, and a side 
select bit, placed in d4.w. mdriv is called to select the drive, 
get the drive up to speed and make sure it is ready, mdriv 
returns with the Z-bit clear if this drive is not the same as the 
previous one. In this case mrdid is called to locate the head of 
the newly selected drive. Next the byte count for a read or 
write command id placed in d2.w and the sector register of 
the WD2797 is loaded. The hardware details of this write to 
the sector register are almost identical to the move.b d4,f- 
cmd(a5). The addq |l,d7 is done because the BIOS starts sec- 
tor numbering at and the WD2797 starts it at 1. 

mdriv: The first 3 instructions prepare data for the control 
latch so that MOTOR__ON is asserted, PROM is off, 5 inch is 
selected, double density is selected and the proper unit is 
selected. This information is sent to two places, one is the 
control latch and the other is dkctrl which holds the ram copy 
of the control latch. A call to mbusy is made to see if the drive 
is ready. If not, a delay loop is executed. A call to mbusy is 
again made to see if the drive went ready. The idea is to sam- 
ple the ready line of the selected disk. If it is ready then exit, 
otherwise delay a short while and then sample again. After 
delay2 tries at this you can assume the drive is not going 
ready so error bit 3 is set and flow passes to merr, the error 
routine. 

If the drive does go ready then prev 51, which keeps track 

of the current drive is updated, mdriv returns with the Z-bit 
clear if the current request is on a different drive from the 
previous request. 

tnrdid2: This routine begins by aiming aO at a 6 byte area 
into which the disk id will be read. Next a byte count is placed 
in d2.w (1 less than the actual number of bytes transferred) 
and a readid command is placed in dl.b. mrd is called to tell 
the WD2797 to perform the readid. The WD2797 status is 
returned in dl.w following the command. The and instruction 
sets the Z-bit if there is no error, otherwise clears it. 

mrdid A call to mrdid2 asks it to read an id field. If no error 
occurs the track register of the WD2797 is updated. If an 
error does occur mrdid steps out 1 cylinder and tries again. If 
all goes well this time the track register of the WD2797 is up- 
dated, otherwise bit 3 of erflag is set and the error exit is 
taken. 

The stepout was chosen because once CP/M 68K is running 
cylinder is not accessed. Also this seemed to work in most 
cases. 

mseek: Recall that rwmini set d6.w to the desired cylinder. 
This is compared with the cylinder register of the WD2797. If 
they are equal no seek is necessary, else a seek command is 
sent to theWD2797. A call to mbusy is made to wait for com- 
pletion of the the command and to get the status. The and in- 
struction clears the Z-bit if an error occurred in which case bit 
5 of erflag is set and the error return taken. If all is well 
mseek returns to the caller. 

mrd: The call to mdisint saves the CPU status register, 
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disables interrupts, sends the command in dl.b to the 
WD2797, aims al at the WD2797 data port and aims a2 at the 
wait flip-flop. The code which follows is the loop to transfer 
data from the WD2797 to memory. Execution of the move.b 
(a2),dl merely sets the wait flip-flop, thereby stalling the 
CPU. When the WD2797 has a byte of data it will assert DRQ, 
clearing the wait flip-flop and waking up the CPU. The CPU 
then reads the data, placing it where aO points, bumps aO and 
decrements the byte count. This loop continues until the byte 
count number of bytes is transferred. If the WD2797 encoun- 
ters a problem it asserts INTRQ, which also clears the wait 
flip-flop. INTRQ remains asserted until the status register of 
the WD2797 is read. In this event data is still transferred but 
it is meaningless. After the data is transferred the CPU 
status is restored. 

mnbinit: This routine restores the CPU status. 

mbusy: A short delay allows the WD2797 time to prepare 
its status register. Now the status register is continuously 
checked until the busy bit goes off. Finally, the WD2797 
status is returned in dl.b. 

You will notice 3 instructions are commented out. The 
reason for this is that they are priviliged instructions. CP/M 
68K runs transient programs in user mode so when testing 
this program these instructions are not executed. However, 
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Figure 9: Data interface to S-100 Bus. 



the BIOS operates in supervisor mode so the *'s can be 
removed when the code is inserted into the BIOS. 

mwr: This routine operates in essentially the same way as 
mrd except the data transfer is from RAM to the WD2797. 
The WD2797 asserts DRQ whenever it wants a byte of data. 
INTRQ operates here the same as it does for mrd. 

merr: The control latch is set to deselect all drives and dk- 

ctrl is set to mirror the control latch, prev 51 is set so that 

mdriv will regard the next selection as new. Finally sp is 
restored and the return made to read (or write as the case 
may be). 

wr-mini: This routine operates much the same way as 
rd mini. 
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Figure 10: Address to Eprom and S-100 
control bus connections. 
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ptrmx: This routine references a data structure which 
holds information about the disk to be accessed. a3 is a poin- 
ter to this data structure. Details have been omitted. 
See listing. 
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Conclusions 

We have been using this controller for 5 months with 5 inch 
TEAC and 8 inch Mitsubishi drives. With the 8 inch drives we 
have been using single sided disks in double sided double den- 
sity mode with almost no errors. This can be done if the Mit- 
subishi drives are properly jumpered. On the 5 inch drives the 
error rate seems to be about the same as my friends who run 
IBM PC's or clones i. e. somewhat higher than on 8 inch 
drives. In all cases (both 5 and 8 inch disks) the errors seem to 
occur when a disk is first used. Once a disk has been format- 
ted and used for a while it usually runs error free. Our 
department has two Stride computers (both run CP/M 68K> 
and we have had no trouble interchanging disks with these 
systems. At present our 68008 systems have a 68008 CPU 
card, this disk controller with 5 and 8 inch drives, two Digital 
Research 64K RAM cards, two Digital Research semi disks 
and a serial I/O card. Students then interface whatever other 
boards they need. ■ 
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Soldering 

/continued from page 201 
give solder the ability to turn liquid at a 
workable temperature. There are dif- 
ferent solders for specialized work and 
these are usuaully not suited for elec- 
tronics because they turn liquid at 
higher temperatures. There is one type 
of solder that is 63% tin and 47% lead 
which is very good for electronics but it 
is harder to locate than the standard 
60/40 type. 

The only real choice in buying solder 
is to select the best gauge for the work 
at hand. Gauge refers to the thickness 
of the solder. Some common gauges are 
.032" which is very fine, .040" and .050" 
both good sizes for kit building, and 
.062" and up. 

Actually gauge is not critical at all, if 
you happen to have a very fine gauge 
then you'll need to feed more into the 
joint to produce a good result, with 
heavier gauges just a little is all that's 
required. It becomes something of a 
personal preference as to what you like 
best. Just be sure to purchase in 
economical quantities, small packages 
can run out quickly and cost more to 
buy. 

Hints And Tricks 

Throughout we've talked about the 
theory of soldering, the tools used, the 
solder itself and a most exhaustive 
discussion of a sticky brown glob (rosin 
flux). Interspersed with these topics 
we've included some basic techniques. 
So to wrapup lets mention some odds 
and ends that can be helpful. If readers 
of this Journal know some more then 
please contribute, knowledge is only 
valuable by its sharing. 

Cleaning Traces 

Modern circuit boards are made with 
copper traces which are then plated 
with a nickel/tin alloy to keep them 
from corroding as rapidly as they would 
if left as bare copper, such traces are 
silver in color. Boards may also have a 
solder mask, this is a coating that 
repels solder, reducing the possibility 
of solder bridges, the mask is either a 
pale green or blue color. If a board has 
either or both of these then you don't 
want to clean it. It's not needed and 
would only damage the plating and the 
mask. However, some small boards may 
show copper colored traces. These 
should be lightly cleaned with fine steel 
wool or one of those nylon scouring 
pads until the traces just begin to shine. 
Do this once just prior to beginning 



work on the board. Even so you may 
find that such boards are more dificult 
to work on, a fine gauge solder may be 
helpful because it provides more flux. 

The other item that may need 
cleaning is the leads of the parts to be 
installed. It's always a good idea to look 
at the lead and if particulary dull then 
lightly scrape it with a utility knife or 
pull it through the closed jaws of a 
needle-nose pliers. Ceramic disc 
capacitors are sometimes coated with a 
wax substance, this may extend down 
the lead far enough to serioulsy inter- 
fere with solering, it also keeps the lead 
shiny, for this reason I always clean 
these leads even if they don't seem to 
need it. 

Parts Positioning 

An experienced hand once said that 
soldering was easy, but keeping the 
parts from falling out before you can 
solder them is the real trick. In almost 
all instances you have to solder a PC 
board bottom side up, you insert the 
part and then turn the board over and 
all too often the part will either fall out 
or slip away from the board. In in- 
dustrial situations the same problem 
has led to several solutions, most of 
which are not really useful to the casual 
builder. 

One industial method involves cut- 
ting the lead just above the pad and 
then bending or staking it over. This 
works great, too great in fact. In the 
next article on unsoldering this 
becomes unsoldering nightmare num- 
ber one, it's also more than is really 
needed for casual work. The second 
method involves bending or forming 
the leads so that when inserted into the 
PC board they press against the holes 
enough to hold the part. This is fine for 
kit builders but it requires special tools 
to always achieve it. Actually, half the 
time this will occur by chance and you'll 
find the part stays in place by simple 
friction. 

A very simple variation of the for- 
med lead method is to insert a part and 
if it is loose then hold it down with one 
hand and with a needle nose pliers in 
the other grasp the lead about a quar- 
ter inch above the board and pull it 
sideways parallel to the board for about 
a quarter or eighth of an inch. This will 
generate enough friction to hold the 
part until soldered. The real diference 
here is that the industrial method is 
done to the part prior to inserting it 
while this variation is done after the 



part is in place. 

Sockets present a slightly diferent 
problem as they don't have enough lead 
length, again don't stake one or two 
pins as that makes unsoldering nearly 
impossible. Yet some people do on the 
grounds that unsoldering a socket is 
impossibly dificult anyways and ex- 
tremely rare as well. My method is to 
insert the socket and then turn the 
board over onto the workbench, ideally 
onto a piece of cloth or cloth over foam 
rubber. Then while soldering I press 
down slightly to force the socket flush 
to the board. I only solder two diagonal 
pins and then I check to be sure the 
socket is flush and that the pin one end 
is correctly oriented before completing 
the other pins. Of course I often do 
several sockets at a time so this isn't as 
tedious to do as to describe. This 
doesn't always work because 
sometimes other parts extend above 
the socket, that's why the foam rubber 
but if that doesn't help I keep a few 
small blocks of wood around that can be 
strategically placed under the socket to 
push it up. 

Wires and Lugs 

Back when kits included lots of 
soldering of wires to lugs there were 
two problems that may have driven 
more than a few folks to swear off kit 
building. Both problems have 
reasonably good solutions and since 
there are still a few instances where 
they may be needed we'll mention 
them. 

When soldering a wire to a switch lug 
most kits will tell you to make a loop of 
wire around the lug and then solder. 
This forms a mechanical connection 
prior to the soldering and it's alright to 
do it this way. But if you ever need to 
undo the connection you'll find that 
usually the wire must be cut and then 
the loop unsoldered. And guess what, 
the wire will then be too short to reat- 
tach, you'll have to splice it or take it off 
the other end and use a new length of 
wire. I generally don't make a loop but 
rather a 90 degree bend in the wire and 
then slip it through the lug, solder it 
and then trim away any excess wire. 
Sometimes if it holds I may just slip it 
through the lug with no bend at all. 
With one exception, I do make loop 
type connections on large wires or 
wires that will carry power. 

The other problem occurs when you 
have to solder a wire to a lug that is 
buried within other lugs and wires. 
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What happens is that as you make the 
connection you notice a foul odor of 
burning wire The cause is that one or 
more of the surrounding wires is being 
charred by the hot barrel of your 
soldering iron One way to avoid this 
aggravation is to use a battery powered 
, iron if you have one (they only get hot 
at the tip). The other solution is to keep 
the wires pulled back. Extra hands are 
great for this if you have them, your 
own that is. don't try to use someone 
elses, like a spouse or relation. You see 
the hot iron may burn the other per- 
son's fingers and then instead of 
charred wires you'll have a charred 
relationship. 

A real easy way to hold back the 
wires is with hold-backs. What are they 
and from what obscure mail order firm 
do you buy them? You don't buy them, 
you make them. Just get a few paper 
clips some bigs ones and some little 
ones, add a few rubber bands some 
short ones and some long ones. Now 
take your wire cutters and cut the 
paper clips just around the bend of each 
loop. Tie a rubber band with a half hitch 
over one loop. To use them just grab 
the offending wires with the open loop 
and then gently stretch them away by 



fastening the rubber band to keep them 
out of the way while you solder. There 
will be always be something that the 
rubber band can loop over. You can 
make as many hold-backs as you need 
and feel free to modify them in any 
fashion. 

Conclusion 

That pretty much wraps up 
soldering, the only thing left is for you 
to go out and try it. If you're just 
begining start with a small project or 
with a scrap circuit board, some surplus 
firms sell such items. Then you'll be 
ready for the next feature, unsoldering. 

Sources 

The following companies publish 
catalogs that you may wish to send for. 
They are listed only for that reason and 
no assertion as to their worthiness or 
lack is implied. As always you should 
exercise reasonable care when making 
purchases by mail. 

Radio Shack catalogs are available at 
most stores. Tools and parts, plus some 
simple kits. 

The Heath Company, Benton Harbor, 
MI 49022, (800) 253-0570, many kits 
from simple to complex, including com- 



puter kits and training courses, test in- 
struments, also some tools. 

Edlie Electronics, 2700 Hempstead 
Turnpike, Levittown, NY 11756, (800) 
645-4722, carries electronic parts and 
tools, for soldering and circuit repair, 
also some simple kits. Catalog is good 
reference for what is available. 

Jameco Electronics, 1355 Shoreway 
Road, Belmont CA 94002, (415) 592- 
8097, many electronic parts, also tools 
and supplies and some kits. Again a 
good catalog to have for reference 
especially electronic spares etc. 

Active Electronics, P.O. Box 8000, 
Westborough, MA 01581, (800) 343- 
0874, large stock of electronics parts 
and also lists tools, no kits though. 

Priority One Electronics, 9161 
Deering Avenue, Chatsworth, C A 
91311, (800) 423-5922. Electronic parts 
and products, also soldering tools and 
circuit repair products. 

The above is only a partial list of fir- 
ms that supply tools and may also sell 
kits. Many others sell only kits, you 
should check the pages of this and other 
technically astute publications for the 
names and addresses of these firms. ■ 
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Apple II Graphics 
(continued from page 13) 



*•**•••••*•» 



"•* twxt'graphics) 



PROCEDURE _ set parti t ion (part :pvtttl on) I 
(••itch batMMn full tcrawt qrtptiici and i 
BEGIN 

CASE p*rt OF 

FULLSCREEN: ^wrhostbytet FULSCRH,#>| 
HI XED: _wrhoetbyta( _HID, • > t 
END I 
END I 

PROCEDURE _selectpage (pagenue: integer )( 
{■Mitch to specified griphiei page) 
BESIN ^ 

IF p«gtnua-l THEN _wrhoetbyte< _PB1 ,#) 
ELSE IF pagenue-2 THEN _wr host byte ( _PB2,») 
ELSE writelnCThere 1* no page ',pManus)l 
ENDt 

PROCEDURE tewtscreen(pegenua:integer >| 
(■Mitch to specified tnt Krt«n) 
BEBIN 

,wlKtpag«(pao*niMl I 
_wrhostbyte< TIT, 01 | 
ENDI 



FUHCTIOH _inrenge(n, loll.lt, hi Ueit: integer > :booleenl 
TrM™"^* 1 "" outBld » °* H«it«— used to prevent dr MII 
outaide the Krtm bcundwiM) 
KB IN 

IF <n>-tolieit> AND (n<-hi I leit) THEN inrenge: -TRUE 
B-SE _tnrange:^ALSEl 
ENDI 

(end of AFLBR/B) 



•AD, sd?, »9», «aS, «2C, »A0, •#*.••«, MC, Ml .«••, «2», • 1*. sFO, *ee\ 
(_AVLIN (»«23-M«3i,— pi t v-rt. Una at col h Mhm 
rowl and row2) 
•AD, «#2.«9«,*09,«2D.tAD,«0« ( •?•,•«<:. Ml, •+*,t2«,«2S,«Fa, !tf» 
> t 
(Borland Pascal's "structured constants" feature la nonstandard. 
So, for that aattar, is any har dwar t - < aac i«ic cod* that sight to* 
generated even «ith standard syntax' This just happens to bo 
a quick and dirty -ay to da* in* a table of bytes that represents 
aS#2 instructions} 
VAR source, dest, Inth: integer I 
PEG IN 

*ource:-ADOR(LORESTUFFC l )) | (starting address of data to sand) 
dast :-««n»#3( (where in tha 63B2' a RAM to put it) 

lnth:-*2Fl (heat aany bytas to sand) 

. wrhostdat a (source, dest , Inth) | 
ENDi 



PROCEDURE loreegr (pagenue.: integer 1 part: parti tion) | 
(Mitch to Iom resolution graphics on specified page) 
BEGIN 

.««lectpege( pagenue) 1 

.sat parti t ion (part 1 1 

_wrhostbyte(_U*S,#) I 

_Mrhostbyte(_GRFi,#>l 
ENOt 



4*«M«t*M«» 



*aea*a*a i 



ntary lores graphics procedures} 



BESIN 

.callapl (_LOCLRSCR> I ( callapl is 
ENDt 



tha file PCP. INC) 



sat col or (color : lor 



APISR/L. INC 



CAPLBR/L.INC enable* calling Iom resolution Apple graphics 
routines froa Turbo Pascal prograas. 
Requires tha PCPI ZBe card (Appllcerd). 
Copyright 19*4 by N.T.Cernevala. 
Pereission granted for nonprofit usa. ) 

(contains these routines: 
PROCEDURE lorespatchl 

— installs tha register-loading routines needed by sate o lor, 

P*° *i "1 in and wlin 

PROCEDURE toresgr (pagenue: integer* part : parti tion) 1 

— invokes lore* graphics 
PROCEDURE clear_lores_screen(pege:integer >| 
clears specified lores page 

satcolor (color: loreshoasH 
— selects color for drawing 
ROCEDURE plot (coluan,row:byte>| 
— puts a point an the screen 

hi in (row, col l,col2:byte)| 
a horizontal line 
vlin (col , row l,row2: byte) | 
— draws a vertical line 

Soa* of these procedures call lores graphics routines 
at the following ROM locations: 

SETCOL - PFB6-4H sat color 

PLOT - BFBMH plot a point 

HLIN * eTBlvH draw a horizontal line 

WLIN - eFB2SH - vertical line 

This requires "poking" a few short aachine language 4o302> 
routines into tha 63*2' a RAM starting at location 9M3H. 
The pareeetare needed by these routines ere -poked" into 
locations <?■■■ 9eV2M (bytes destined for the A and V registers 



atio 



2CH < 



2DH). 



1 or eshues- ( BLACK , NASENT A, OARKBLUE , PURPLE , DARKBREEN,8NEY1 , 
rCDIUHe^, L ieKTeLuE,aRC»«,ORA>«E,8REY2,PINK, 
LIBHTSREEN, YELLOM, AOUA, WHITE) | (lores colors} 

CONST 

<1om resolution constants} 

LOHRES-401 (« of pixels across tha screen) 

LOVRES-481 <full screen vertical resolution) 

LOMIXVRES-4*! (ai.ed aode vert res} 

.LGRESPASE 1 *«4e»| (start of lores page 1> 
_LOR£SPABE2-s6e*| (but can't use page 2 with App Heard 1 
Overlaps with vital drivers!'? 1 ) 

(•••ilYecceeeible ROM routines for lores graphics} 
_LOCUtSCR-sFa32t (clears whole lores screen) 

_L0CLRTOP-sFS3el (spares four text lines at bottoa) 

(The following addresses in the eSB2's RAN ere used by 



(specify color t 

WAR kolor:bytel 

BEBIN 

kol or : «0RD (col or 1 1 
_wrhostbyte< AREB.kolorH 
.callapl ( ASETCOLM 

ENDt 



use for drawing) 



plot (col uen, row: byte) < 
(draw a point at specified location) 
BEBIN 

IF _inranee<coluam,e,LOHRES> THEN 

IF _inrartge(row,0,LOvRES> THEN BEBfN 
_wrhostbyte( _ARE8, row) % 
_wrhoetbyte< YREB.cotuen) t 
cal lapl (_APLOT) I 
ENDt 
ENDt 

FUNCTION _lc«-esclip(n,lolisit,hllieit: integer): integer l 

(called by hlin * vlin to prevent drawing outside screen aarains) 

BEBIN 

IF n<lolieit THEN .lorescl 

ELSE IF n>hilieit THEN _la 

ELSE laresctip:-m 
ENDt 



-lol iait 

cl ip:^ii lia 



PROCEDURE hi infroM.col l,coI2:byte) I 

(draw horizontal line at "row" froe coll to col 2) 

WAR teap:bytet 

BEBIN 

IF _inrange<row,e\LOVRES) THEN 

IF .inranga(col I.d.LOHRES) OR inrengeicol 2,«,LOHRES) 
THEN BESIN 

col l:-_lore*clip(col l,*,LOHRES>t 
col2:-_loresclip<col2,«,LOHRES) | 
IF coll>col2 THEN BESIN 
teas: -col It 
col l:*col2l 
col 2: -teepf 
ENDt 

.wrhostbyte<.AREB,row>| 
.Mrhostbyte<_YREB,col 1)| 
_wrhostbyte<_LOCXX,col2)t 
.callapl (.AHLIN) I 
ENDt 
CNDt 

PROCEDURE vl in(col ,rowl,row2:byta)l 

(draw vertical line at col froe rowl to row2> 

WAR teep:bytet 

BEBIN 

IF _if^ange(col,*,UMeIS> THEN 

IF .inrengetrowl.B.LQVRES) OR inrange(row2, B.LOVRESI 
THEN BESIN 

r »* :-_lorescl ip (rowl ,R,LOVRES) % 
roM2:-_toresclip<row2,«,U}vRES) I 
IF rowI>raw2 THEN BEBIN 
tewp:-r ca.lt 



row2:-te 



91 



»*t col or, plot, him and vlin) 

_ASETC0L-«9se3l (sat color) 

_Afn.0T-«9eeA» (plot a point at coluen.ri 

_AHLIN-S««14t (plot horiz. line at row 

_AVLIN-«9B23l (plot vert, line at col h 



n col 1 and cot 2) 
> rowl and row2) 



1 *****—****«•«•• ■ssseeeseaaai mi t ) 

tM *** * r " routines to be patched into eot her board' a RAN at 
• 9 "»3-»»* T 33 so that setcolor, plot, hlin and vlin can be used) 



ENDt 

.wrhostbyte ( _ARE8 ( riM , , , 
_wrhostbyte < .YREB, col ) | 
_wr host byte ( _LOCI X , row? > t 
.callapl ( AVLINIt 
ENDt 



■respatcht 
(installs the register-loading routines needed by 

setcolor, plat, hlin and vlin) 
CONST 

LORE STUFF: arrm Y tS»l..»2F3 of byte-( 
(_A8ETCOL <9W3-9M9) — set color) 
•AD, •*#, *«e, «2P, «o4 , «FB, M«, 

t_*PL0T ( 9 BB A 9B13) — plot a point at col uen h, row v) 
•AD, •#•,•?•. sAC, Ml ,••«, »2B, *#•, «FB,sa«, 
C.AHLIN (9V14-9B221-- plot horn, lino at row v between 
col 1 and co!2) 
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Portable programming environment 



Whether you program on the Macintosh, 
the IBM PC, an Apple II series, a CP/M 
system, or the Commodore 64, your pro- 
gram will run unchanged on all the rest. If 
™ you write for yourself, MasterFORTH will 
protect your investment. If you SSS^S 3S 

write for others, it will expand S ^SZ SSSS 

your marketplace. 55— 2 TStm 

^^L MasterFORTH is a state-of-the-art imple- 

^k V mentation of the Forth computer language. 
V ^m Forth is interactive - you have immediate 
t m feedback as you program, every step of the 
way. Forth is fast, too, and you can use its 
built-in macro assembler to make it even 
faster. MasterFORTH's relocatable utilities, 
transient definitions, and headerless code "^ei tm 
let you pack a lot more program into your memory. The 
resident debugger lets you decompile, breakpoint, and 
trace your way through most 
programming problems. A string 
package, file interface, and 
full screen editor are all standard features. 

MasterFORTH exactly matches the Forth-83 Stan- 
dard dialect described in Mastering Forth by Anderson 
and Tracy (Brady, 1 984). The standard package in- 
cludes the book and over 1 00 pages of supplemen- 
tary documentation. 






CP/M 



MasterFORTH standard package 

Macintosh „ . .$126 

IBM PC and PC Jr.*MSeoS2.1)._„..125 

Apple H,IH-,Me, He (DOS &3> 125 

CP/M 2. x (IBM 3740 »■).... „ 126 

Commodore64 - M ..,,..,«.»...».40B 

Extern ,- jtr 

Floating Point (IgMFVttWamiam.... .180 

9m *ww*/~ - v* - 




MICROMOTION 



12077 Wllshire Blvd., #506 
Los Angeles, CA 80025 




LISTING 4. 



APLGfi/H. INC 



utton Apple graph i 



<APt_6R/H. INC enable* calling hi reeal 
routines froa Turbo Pascal progrMt. 
Require* the PCP I Z&m card (Applicerd). 
Copyright 1984 by N. T . Cvntvil e. 
Per ei in on gr anted for nonprof 1 1 use. } 

(contain* these routine*: 
PROCEDURE hirespatchi 

--install* the regi ttsr-loadmq routine* to be patched 
into eot her board'* RAM at •9e32-«9«e so ROH hires ro 
c an be used 
PROCEDURE hiremgr (pagenuw: integer | part:partition> t 

— i nvoke* hi re* aods mi th *pec if i ed page and part 1 1 ion 
PROCEDURE c leer hi re* screen (page: intager ) | 

--clear* specified hire* page 
PROCEDURE hgrselect (*crn: integer ) | 

— select and clear specified page 
PROCEDURE hqrcl ear t 

--clear hires screen 
PROCEDURE hi sstcol or (colgr ihiraahueil I 

— set color for drawing 
PROCEDURE hplot (coluan.rM: integer > i 

--plot a point at specified location 
PROCEDURE hi ine(de*tcol , destrow: integer ) | 

— draw from present cursor to destination 
PROCEDURE *etbackground<tint :hirtshu*t) I 

--specify color of background 
PROCEDURE set cursor (col man, row: integer ) I 

--put cursor at a location 



of the following ROM 



SaaMr of these procedures invoke 

hire* graphics routines: 

HSR - «F3E2H invoke hires display pege 1 with 4 tent lines 

HGR2 - 0F3O6H invoke hires display pege 2 <full screen) 

HCLR - PF3F2H clear current hire* pege 

BKGNO - 0F3F4H set background color 

HCOLOR - 0F6F0H **t color for hires drawing 

HPLOT - 0T457H position cursor t plot a point 

HL 1NE - BF53AH plot a line 

HPOSN = 0F411H set cursor at h,v without plotting 

— call before "draw" 
5HPTR - 0F730H sets up shape pointers 

(Reference: pp. 69-71 in Apple Qraphics e Arcade Bsee Design, 
by J.Stanton (The Book Co., Los Angeles) 19S2. > 

Thi* requires "poking" a few short routines into the 6asT2's RAM 
starting at location 9003H. The psraeetera needed by theee 
routines are "poked - into locations ? ■— 9 A02H (byte* destined 
for the A and Y register* and location 4SH) . 
) 



( Other Hire* graph i cs locations 

COLRTBL » 0F6F6H start of color table 

HLCOOR0 - 00E0H two byte horizontal coordinate 

VCOORD - ME2H vertical coordinate 

CLRMASr. * ME4H color easking word froe color table 



PAGENUH < 

SCALE 

SHAPTABL 



• 20 for page 1, s40 for page 2 
scale lector for shape drawing 
two byte adore a* of shape table 



TYPE 

h i r tshues- ( BLACK 1 , 8REEM , V 1 OLfT , MH I TE 1 , BLACK 2 , ORANBE , BLUE . leH I TE2 > 1 

CONST 

(hires constants) 
HIHRES-2S01 
HIVRE 9-1921 
HIMIXVRES-1A 
HIRESPABE 1 -4-2000I 



(• of pixels across the screen > 
tfull screen vertical resolution 
(si wed eode vert res} 
(start of hires page 1) 



HIRESPASE2-«4ee«{ {start of hire* page 2) 

Ceaey ROM routines to call — no parawsters needed) 

_H8Rw*F3E2( (invots hires display page 1 with 4 te»t lines) 

HSR2*«F30e; (invoke hires display pege 2 (full screen)) 

HCLR-SF3F2; (clear current hires pege) 



(The following 6302 NAM locations will be patched to hold 
routines that allow access to the ROM graphics functions, 
such as setcolor, hplot, hline etc.) 



_AHCOLOR-««s132t (PURPOSE: 

SETUP: 
_AHPL0T-S9#:39t 



_AHLINE>«904e| 



_ABK8ND-«9033| 



set color for hires drawing 

poke color into IRES) 

draw a point at location h.v 

poke v into ARCS, lo byte of h into 

IRES, hi byte of h into VR£8> 
drew a line froe initial cursor 

location to specified point 
poke v into VREB, lo byte of h into 

ARCS, end hi byte of h into KREB) 
set background color 
set color before calling, then potto 

color eask into AAEB) 
put cursor at location h.v 

without plotting 
poke v into ARCG, lo byte of h 

into IRES, hi byte of h into VREG 

— sass a* for AHPLOT) 



PROCEDURE hirespetchl 

(install* the routines to be patched into the 6302' a RAM.) 

CONST 

(where this patch starts and how long it is) 
CODE START* 69*3 2 1 
CO0ELENSTH-S34I 

(Borland Pascal'* "structured constants" feature is nonstandard 
So, for that setter, is any hardware-specific code that eight 
be generated even with standard syntao ' This just happen* to 
be a quick and dirty way to define a table of bytes that 
represent* 6302 instructions) 
H1RESTUFF: array [ tel . . COOELEN6TM1 of byte-t 
( AHCOLQR) 

•AE,*#2.«9«,S2e,»FB,SF6,**e 1 
( AHPL0T) 
tf*. t#2,«90, SAB, •00,»90, SAC. S01, see, »20,«37. •«,»*#, 

(_AHLINE) 
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*A£, —?. ««h», *AD, *dd, •<?•, *AC, Ml . «9«, «2». «3A. »F3, ft**, 

C ABKGND) 

•A5,*€4,«2P,SF4,»F3,*««#, 

*A£. M2, t9P. «AO. §••, •*•• *AC. «•!.•••, •2»,«11. «F«, Sad 

> I 
VAR taurci.dMt, Inth: integer 1 
BEGIN 

»ource:-ADDR<MlRESTUFFCl J) I 

de«t:-COD€STARTl 
lnth:-CODELENBTHI 
MThoitd«t« i iaur c«, d««t , Inth) I 
END; 



*##**••*•*••»•■**•■ 



PROCEDURE hiresgr (psgenue: integer I part : parti Hon) i 
(tnvoka htrM eode with ipKiMad page end partition) 
BEGIN 

sslectpagetpagenua) l 

_»etpartition (parti i 

_wrho«tbyta < _H*S, •> I 

_wrhoatbyt»<_SRFX,»> I 
ENDl 

< #« ####*#••••*•••♦••••*•••***••••♦*•*••*•**'•***•*♦***•***'•**' 

(ElMMntiry hires graphics procedures) 

PROCEDURE cleer_hires_screenl 
BEGIN 

HritilnCduaiy routine to cImt hires Kr«tn')l 
END! 

PROCEDURE hgrseleet(*crn:integer> I 
(select and clear specified page) 
BEGIN 

IF scrn-1 THEN _cal 1 apl <_MGR> 

ELSE IF Krn«2 THEN ,c*l 1 apt ( _HBR2> 

ELSE wri tain ( ' There Is no page '.■cnJ* 
END* 

PROCEDURE hgrc Ittrl 
(claar hires screen) 
BEGIN 

callapl <_HCLR>I 
ENDt 

PROCEDURE hiMtcolcrlcolor:hir«h«MH 

(set color for drawing) 

BEGIN 

«rhostbyte<_*R£B,ORD (color) >l 
'callapl <_AHCOLOR)| 
END I 

PROCEDURE hplotfcolueri.roelinteoerU 
<plot a point at specified locus! 
BEGIN 

IF inranoa)(colupn,0 ( HIHR£8> THEM 

IF inrenge(row,d,HIVRES> THEM BEGIN 
_wrhostbyte< .AREG. lotroe) 1 1 

_wrnostbyta<_XREO, lo(coluen) > I 
_wr host byte ( _VRE8, hi <col uen > > I 
callapl ( Afs*LOT)l 
END I 
ENOI 

PROCEDURE hlti^(de*tcol,ds*,tro»:inteoer>l 

(Drew from priMnt cursor to dest. Umi truly cruda clipping 1 ) 

BEGIN 

IF tnranoeMde*tcol,d,HIHRE&) THEM 

IF inranap<dMtroM,f),HlVRES> THEN BEGIN 
wrhostbytet ARES, lo (dest col > > I 
_wrhostbyte(_XNEB,hi (destcol ) >l 
_wrhostbyre(JrT4EB, lo(o*atro*H I 
_callapl<_AHLINE>l 
ENDt 
ENDt 

PROCEDURE — tbackground<tlnt:hir»ahue«n 

(•pacify color of background} 

BEGIN 

hisetcolor (tint) I 
callapl (_ABK8ND)I 
ENOt 



PROCEDURE ss*cursor <coluen,row,tinteQ 
(put cursor at • specific location) 
BEGIN 

wrho*tbyta(_ARE8.1o(raw>>l 
wrhostbytel XRES.lolcoluflnMl 
~wrhoetbyte< yRES.hKcoitawMI 
'callapl (.AHPOOMll 
END* 

(and of APLGR/H> 



r>t 



.BLOCK ^ BPPII ;put thu above tha driver area 

Ihrit, loci for tMpcr«-v storage 
AREG: .BLOCK 1 itha «:r*tchpad to *ich tha? Appli 

YRE6: .BLOCK 1 Icird wit** data daattnad far 

LOCI*: . BLOCK t I A. V. and 2C or 2DH 

CODESTART: (beginning of patch araa 

l •••••••«••••»••••••*•*•• 

JRUUTINE: ASETCOL 

[PURPOSE: »at tha color used for drawing 

;SETUP: poka -color" bytt into ARES befors calling 

asetcol: 

LDA ARES 
JSR SETCOL 

RTS 

; ROUTINE: APLOT 

;PURPOSE: plot a point at coluan h, ram v 

t SETUP: poka h into v»EG, v into ARE 6 bafort calling 

APLOr: 

LDA AREG 
LDY VREG 
JSR PLOT 

RTS 
I •«•••••••*♦*••••••••*••• 

; ROUTINE: AHL IN 

: PURPOSE: draw a horizontal lina at row v batwaan 

coluan* hi and h2, where hl<h2 
;SETUP: poka v into ARES, hi into VREG, 

1 and h2 into LOCH before calling 

1 ••*••••••*••••••*••••••• 

ahlin: 

LDA LOCH 

STA H2 

LDA AREG 

LDV VREG 

JSR HLIN 

RTS 
I 

{ROUTINE: AVLIN 

; PURPOSE: draw a vertical line at coluan h between 

I row* vl and v2, where vt<v2 

(SETUP: poke h Into VREG, vl into AREB. 

t and v2 into LOCH before calling 

I +4f— ++•+•*•*+••+—••• 

avlin: 

lda locxx 

STA V2 
LDA AREG 

LDY YREB 
JSR VLIN 
RTS 
I 



show long the whole works is: 
LENGTH: -EOU FINI9M-C0OESTART 



.END 

t 

lend of L0RE9.AU 



LISTING 6. 



(Copyright 19S4 by N. T.Carnpvale. 
Per ei a* i on granted for nonprofit use.) 

(VI POP. INC) 

CSl APLSR/6. IMC) 

(SI APLGR/L. INC) 



VAR 

anslchari 
tern: integ 
h, v: inteqe 



tint: la 



rd reeponeee) 
(which lo-res graphics sere 
(hornontal and vertical co 

— top left - •",•> 
(color used for dreeing) 



n to use) 
rdinetes 



PROCEDURE detayt (about 4 

VAR i , j: integer t 

BEGIN 

FOR i : -d TO 3dd DO 
FOR j:-t TO 3d* DOl 
END! 



■lay) 



LISTING S. LORES. AeS 



(LORES. AeS 

(Purpose: enable calling Apple low resolution graphics 

I routine* froa CP/H using the PCPI ZGp card (Applicard). 

■Copyright 1984 by N. T. Carnevale. 

iPereiasion granted for nonprofit use. 

t 

1 • 

jAsseeole with AeS, then use hew codes of the -PRM file to 

[generate the code which will be written to the eot her board 

, roh Lores graphics routines — 

SETCOL: .EOU 0FBe-4H I set color 

PLOT: .EOU PFOBUH I plot a point 

HLIN: -EOU •FG19H Idraw a horizontal llnp 

VLIN: .EOU «FB3GH 1 * vertical tine 

I Other Lores graphics locations 

H2: -EOU P-2CH irighteost end of hortiontel llnp 

V2: -EOU M2DH loot toe end of vertical line 



BEGIN 

lorespatchl (install the register-loading routines) 

writelni 'Low-resolution graphics exerciser* i | 

write ('Press return to clear and fill screen l: '>l 

readlntansM (can't use lores screen 2) 

loresgr < 1 , FULLSCREEN) I (display lores screen 2) 

clear lores screen I (clear it) 

tint:-pLAOCl (start »»th black) 

FOR v:-P TO LOVRM-1 DO BCGIM 

setcolor (tint)l (use specified color) 

hlin(v,d,U»fMES-l>t (draw horn line acroee aire 

IF tint-WHITE THEM tint: -•LACK 

ELSE tint:-9UCC(tint)l (newt color to use) 
ENDl 
del ay I 
FOR h:-d TO LGt*ES-l DO BEGIN 

setcolor (tint) I 

vlin(h,d,LOMbEG-l)l (drew vert llnp down scree*) 

IF tmt-MMITE THEM tint:-PLAOC 

ELSE tint:-GUCC(tint)l 
ENDl 
del ay I 

te«tscreen(D I (returt* to the test display before mm, 
END. (end < 
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LISTING 7. SINES. PAS 



strata* plat of slow tivtctian) 



(Copy?- 1 ght 1964 by N.T.C«rncval«. 
Piraittian granted far nonprofit use.) 

CONST 

BRAFSCREEM-2E (um only hirw screen 2 
BELL - 7 I 



ith PCPI v.2 CP/N) 



real hot Id' onto the display) 
rdinatn, that ts, "real data.*) 



nto display) 



TYPE 

(these are used to aap the 
realdata-RECORO 

v,y:re«ll Cxfcy Mgrld coi 
ENOl 
»c r a»nd a t a -RECORD 

",y:mtaq-rl (**y diaoli 
ENOl 
realscalefactor s-RECORD 

ex ,*y ,bn , by : real t (utad 
END I 

(•I PCP. INC) 

(*I APLHR/6. INC) 

<•! APL8R/M. INC) 



VAR 

ens: char | 

fraaaloc , f rawest xe: screendstai 
lower left , upparnght : real data I 
fraaa>:ra«l seal a-f actor * I 
huf.hir tihum I 

{•I PLOTTER. INC) 

(PLOTTER. INC contain* tha following: 
PROCEDURE Mtfraaa — Mta up the coefficients Caagnificatn-ii 
and "shifts") that are utad to transform or sap "real data" 
to tha display. Parameters are: 

I out 1 of t , upper r i qht : real dat a — the oppeaita corners of 
a rectangular area that contains the ranqa of "real 
data" to b» plottad l*cornar» of tha real world"), 
frameloc: tcraandata — left upper cornar of mrmm on tha 
icraan whera tha data n to go (where to put tha 
pictura) . 
fraee* we: screendata — diaMjnaiana of tha mrmm on tha 
icraan xhara tha data is to go (how big to aakt tha 
pictura) . 
VAR fraat:raalacalaf actors — this record contains the 
coefficients (calculated by setfraee) that Mill be 
used by other procedures to eep "real data" to the 
displ ay. 

plot — draw* a point on the hires page using 
ecifted scale factors. Parameter* ere: 
point:raaldata — *,y coordinates of the point in the 

-real world." 
frame: *c*lef actors — the coefficients used to map 



the point onto the display. 

PROCEDURE plotline — starting froa present cursor location, 
draws a line to tha point on tha screen that corresponds 
to a specified andpoint in the "real world." using 
specified scale factors. Parameters are: 

endpoint:realdata — x.y coordinates o-f the end of the 

line in the "real world." 
tr mmm: seal ef actors — the coefficients used to map the 
point onto the display. 



PROCEDURE genplotl 

(generate and plot one cycle of a sine wave) 

CONST PI-3. 1415926; 

VAR 

i : integer t 

point:raaldatat 

dv:reai t 
BEGIN 

point.«;w).H 

dx:-#.#2*pi f 

point. y: "Sin (point . x ) 1 

plot (point, fraewt) | 

FOR i:-l TO IN DO BEGIN 
point.* : "point. k ♦dm 
point. y: -sin (point.x > 1 
plot! tne (point* frame) I 

END I 
END I 



(plot the first point) 
(calculate the newt point) 
(end draw a line to it) 



BEGIN 

hireapatchi (install regi ster-loedtng routines) 

writelnCSine plotter' >| 

write< 'First, screen ' .enArsCPEEN, 

' will be cleared — press return to proceed*) I 
readln(ans) t 

nor select < GRAF SCREEN) I ( select screen to use) 

hiresgr ( 8RAF SCREEN, FULL 9CRCEN) I ( and clear tt) 
textscreendH (restore text display) 

writelnl 

writelnt 'Press return to plot sine function. *l| 
writelnl 'After the bell rings, press return again* >| 
writelnC to leave graphics eode. ' > I 
reedln(ana> I 

(specify Haiti of "real world" data) 
lower laf t.x:-«.«l lower lef t . y : — 1 -»l 

uppernght.x:-2*PII upper r i ght . y: -1 .#1 
(set up size of display area) 

fraaaesize-iC-MIHRES - 9*1 f raawtei ie. y:-*U v*C6 OIV 21 
(put first free* at top left-hand corner of display) 



fra 



fra 



el a 



-y:- 



hiresgr (BlbVSCRCEN.FULLSCfsEENM (go beck to graphics) 
hoe:-BLAOUl (first "color" to use) 

REPEAT 

hue: -sue c C hue) t (advance to the next color 

hi set col or (hue) t 

frameloc. y:-frameloc.y+t*| ( and ehift the free*) 

f rami OC. « : -f raaaloc. x* 121 

set frame(lamerle«t,upperrimht,f raaaloc.fr eeeei ze.fr see 



genplotl (plot one sine wave) 

UNTIL hue MHTE2I 

wr»teln(chr (BELL) U (ring the bell) 

readln(ans)| (wait until return key is pressed) 

tex tscreen i 1 ) ; (restore tent display before exit') 
END. (and of 



LISTING B. PLOTTER. INC 



rid coordinates, that ts, "real data") 



(PLOTTER. INC — what it take* to set up a frame 
and plot data into it. Written for floating point data. 
Copyright 1964 by N. T. Carnevala. 
Permission granted for nonprofit use.) 

(•This file suit be included after PCP, APLSR/6 and APLGR/H, 
The following types (and corresponding variables) au»t be 
defined in the earn file before PLOTTER is included: 

TYPE 

real date--RECaRD 

k , y :reel I (xliy 
ENDl 
scr eendat a^ECORD 

x.y! integer! (xfcy display coordinates) 
ENDl 
real seal ef actor s-fl CORD 

ex.ey.bx , by: r wall (used to eep world into display) 

end; 

PLOTTER contain* the following procedures: 

setfraee — seta up the coefficients ("aag n i f i cat ions" 

and "shifts") that are used to transfore or eep "real data" 
to the display. ParasNtter* are: 

1 UM *r lef t, upper right : real data — the apposite corners of 
a rectangular area that contains the range of "real 
data" to be platted ("corner* of the real world"), 
f raeeloc: screendata — le*t upper corner of mrmm on the 
screen where the data la to go (where to put the 
picture) . 
f reemsizelscreenoata — dieensions of the area on the 
screen where the data is to go (how big to sake the 
picture) . 
VAR freee:realscalef actors — this record contains the 
coefficients (calculated by setfraoe) that wi 1 1 be 
utad by other procedures to eep "real data" to the 
displ ay. 

plot — draws a point on the hire* page using 
specified scale factors. Parameters mrmi 

point : real data — » , y coordinates of the point in the 

-real world. " 
f reme:scalef actors-~the coefficients used to eap 
the point onto the display. 

plotline — -starting froa present cursor location, 

draws a line to the point on the screen that correspo n ds 
to a specified endpotnt in the "real world," using 
specified scale factor*. Parameters are: 

endpoint:reaIdata — x.y coordinates of the end of the 

line in the "real world. " 
fraee:*c*lef actors — the coefficients used to eep the 
point onto the display. 

Procedure* not in this file that would be nice to have: 
— "eoveto" a specific location without drawing a point 



(unlike plot, which eoves the cursor to a point and 

draws a point there) 
— "relative" cursor eoves (plot and plotline put the 

cursor at a specific or -absolute" location on the 

display 
— true clipping, so that, if one or both andpoint* of a 

line lies outside the defined freee, only the portion 

of it that is within the framm will be drawn 
— a circle drawing procedure 



(set* up the scale factors used by the plot routines) 
PROCEDURE setfraee 
( lower lef t, 

upperr ight:realdatai (data lteits) 

fraeeloc:screendatat (l»ft upper corner of display area) 
framestzelscreendatal (dieensions of display area) 
VAR freme:realsc«lef actor* (calculated by setfraee) 
) t 
BEGIN 

WITH frame DO BEGIN 

bx:>fraatloc.«-*)itlOMarlrft.x| 
■yXfriiMiia.y-l > / < lower left . y-upp> 

(note: Apple' s screen is "upside down") 
by: -frameloc. y-mysupperr ight . yl 
ENOl 
ENDl 

(put cursor and plot a point at a specified location) 
PROCEDURE plot (point : real datal f ramm: real seal ef actor a 1 1 
VAR h, v: integer! (actual display coords) 
BE6IN 

WITH fraee DO BEGIN 

h: -round (ex •point. x*bx ) I 
vl -round (ayapoint . y*by> I 
hplot (h, v) | 
ENOl 
ENDl 

(draw a line froe present cursor location to specified andpoint) 
PROCEDURE plotline(enopomt:re*ldatai f raemr.realacelef actors) I 
VAR h,v: integer! (actual display coords) 
BEGIN 

WITH fraee DO BEGIN 

h: -round (eo» aendpoi nt . * *o* > I 
v: "round (ey»sndpoint.y»byH 
hi ine(h, v) f 
ENDl 
END; 

(end Of PLOTTER. INC) 



erlef t.>)l 
rright.y) 1 
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LISTING 9. Dl»*»SCRN.PAS 



PRCJ8RArl duapKrm (duaps * hirw icrtm to the prints*-. 

A**u*as the print**- cv-d is io4tx*r«-t:oap«t 1 bi * with 

th* BRAPPLER. 

Copyright 1 9B4 by N. T . Cirmvi 1 *. 

Pereissian qr«ntM for nonprofit us*.) 



2 -ith PCPI v. 2 CP/M) 



CONST GRAFSCREEN-2I (us* only hir M 1 

(•I PCP. IMC) 

C*I APLOR/6. INC) 

<»I APLGR/H. INC> 

TVPE «tnnq7#-»trinq(7«]i 

VAR 

size: (singt*. double) I (tpicihit 1:1 or 2:1 Krtwi dusp) 

imlchwl 

controlstring:stringC4]| (uMd *or print**- card cosMntt*) 

i ,nual f ,copynua: integer! 

scrn: integer I 

PROCEDURE delay! 
VAR i,j: integer | 
BEGIN 

FOR i:-« TO 30* DO 
FOR j:-l TO S» DOl 
END I 

FUNCTION prasptant (praspt : string 70) :ch*r I 
(display the proapt an ths> consol*, 
get a singl* upparcaM r*iponi« frost th* keyboard) 

VAR ans: chart 
BEGIN 

Mr tte<proapt> t 

readln(ans) | 

proapt ans: ■upciMlmi) | 
END I 

PROCEDURE duapitl (tell Sreppler to do th* screen duap) 

WW i: integer! 

BEGIN 

ans:-proapt*ns< 'Adjust top *dga of paper, than press RETURN' > I 

FOR i:-l TO nualf DO art t*ln < I st I I (blank Una* for centering) 

wr itelnUst.chr <•) , chr <23> , control string > ( (null is for safety's sake) 

FOR i:-l TO nualf DO **- 1 teln ( 1 st ) * (aorf blank lint* after duap ) 

ENDl 

BEGIN 

textecreanUM (intur* text display at start of proqraai) 
hirespatch! (install register-loading routines) 

REPEAT 

write! 'Ouapi ng s creen ' , 8RAFSCREEN, ' — ' ) | 

•crn: «ORAF' SCREEN t 

hiresgr (tern, FULLSCREEN) I (snows tha screen without clearing it) 

del ay I 

twt»crtsn(l)| (return to text display) 



md f or **gn idad 



ans: •oroaptini ( " Plrocaad or Qiuif ' if 
LWTIL ans IN C *P' . '0 - J; 
IF ans-'P' Tr*ZN BEGIN 

■ n»: "proaptwit ' ' D>oubl • or Sltandard size'* ' )| 
IF #rn='0' THEN BEGIN 
nu«l * - =9( 

cofitrol»tnnq: -' GDR2 ' I 
END ELSE BEGIN 
nual f : -i9i 

control itrinq:-' GR2 ' ; (standard screen dutap) 

ENDi 

•rittlni 

w i t » r Nusbar a* copi*« to aakt: 'li 
r-»adl n icopynual ; 

FOR i : c 1 TO copynu* DO duapitl (do th* *creen duap ) 
-r i teln < ■ Check top edg* of paper and rtiat printer'); 
END: 
END. < * PROGRAM fluepscrn) 



LISTING 10. SAV5CRN.PAS 



phug*A« ,av* C rn; (,-v*. * hl r „ ^rmmn lo dimk . 
Copyright 1984 by N. T . Car neval *. 
Permission granted *or nonprofit us*.) 



CONST GRAFSCREEN-2; ( UM only i 

(*I PCP. INC) 

(SI APLGfi'G. INC) 

(*I APLG*/H. INC) 



screen 2 with PCPI v. 2 CF/H) 



TYPE 

5tnnq7»-*tnnq( 7#J| 

byt*»ch*r j 

screenl ine-array C t . . BPL. ) of bytal ( BPI_ ts 

*tgfiI*«FlLE of *creenline( 

VAR 

an*: char ; 
scrn: integer ( 

PROCEDURE delay) 
VAR i , j: integer: 
BEGIN 

FOR i : -« TO 34M DO 
FOR ,:-i TO 5## DOl 
END; 

FUNCTION proaptanstproapt: strtng7#) :char I 
(display proapt on aonitor, 

get upptrtiia *mgl* character froa kayboard) 
VAR ans: char I 



•*t »^ w -- === - - fl se^se B ) 

*^^? #*"'..- — -■ ■ ^-- . D I 
t '•;===■ 3 m .-?•! ....... , 

i ----...- i :4 * ^e*v...„ o o 1 

\ -mr " * . o # 

• . -e . r ° ■• 

, ( * V \ 1 • 4 -•"" -o 

* :::::::: t !'::::: \ :::::::::: i :::::::::: i ::;;::::;: * :z;; <> 
/..::::::< :::::::::: « :.::::: i :::::::::: i ::::::::: i :::::::::: y-^i ; 


INTELLICOMP 

Introduces 

Inexpensive 

S-100 68008 

CPU Board 

t, or $265 assembled and tested, 
on disk for $20. The board works 
ks. A detailed description of the 

enings best time) or write to : 

3085 


, «~*?' ',. __ ,— • ■ . ,_ tSt- <-^'^T^*' , 


lMBIIIM?^^*Hili?Hlitli!llulliHlliininMH n )Mi "^^^^^^jj 

The card pictured above is $65 for the bare board, $210 for the ki 
It uses only standard parts. A sample BIOS for CP/M 68K is available 
fine with Digital Research Computers 64K RAM boards and semi dis 
board appears in Issue 16 of The Computer Journal. 

For additional information call Intellicomp, Inc. at (614) 846-0216 (ev 

Bruce Posey 
Intellicomp, Inc. 
292 Lambourne Ave., Worthington, OH 4. 
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BEGIN 

•ri te< 
rtadln 
prompt 

end; 



n»: >u(ic«Mt«nt) t 



FUNCTION ro««t«rt(roM,piga:intt9fr):intaqwl 

(calculata the it*rtmg widi-ili corrttpondinq a Una or row nueajer > 

VAR Biqtti««*:inttqarl 

BEGIN 

IF paqe-1 THEN pageoae*:*HIR£SRAGEl ELSE pagebas*: -HIRESPAGE2I 
roMtirti-pagatiiM * S2e*(rOM SHR 6) * < < <ro« SHR 3) MOD B! 3MU 7) 
* (<roM HOD 8) SHL 10) ; 

END J 



l In 



(• 



nqt I2H 



ead and save a 



rt«n to dl 



<> 



t la 






t eap: icrttnl l ne« < 
BEGIN 

xrittfTU* to rec 
readlnif i lnta) ; 



aporary array to hoi d a 1 i 

ve picture: ')| 



rwrittK ) 1 

FDA linatiuAlH) TQ (HIVRES-1) DO BEGIN 

(read _8PL bytes from the display imo tv, starting at 
the address that corrnpondi to the tin* nuaber , 
into the array teepCJ) 
_rdhoatd*ta<rowstart II i nemaa.BRAFSCREEN) , addr < tee* CI ]) , _BPLI 
(wvi the array a* bytes in the file) 
Mrit«(<,tMp) ; 
END; 

doM(f > ; 
END; 

BEGIN 

Play 



(guarantee text display at program sta 
(install register-loading routinw) 



t«xt«cr«an < 1 > 
hi respatch; 
REPEAT 

writeCSaving screen ' , BRAFSCREEN, ' — ' ) I 

icrn: -OR AF SCREEN) 

hiresor (mcrn, FULLSCREEN) i Cshow* the icr 

dalay; 

tfnticraiii < I > I (raturn to taxt display) 

•fM:>pro*pt«n«( 'PlrocNd or 0)011"* ")i 
UNTIL ana IN t'P' . '0' 3( 
IF «ns«'P' THEN doi t! 
END. (and of PROGRAM uvicrn) 



without claaring 



FREE SOFTWARE 

RENT FROM THE PUBLIC DOMAIN! 

User Group Software isn't copyrighted, so there are no fees to 
payl 1000's of CP/M and IBM software programs In .COM and 
source code to copy yourselfl Games, business, utilities) All 
FREE! 

CP/M USERS QROUP LIBRARY 

Volumes 1-92, 46 disks rental— $45 

SIQ/M USERS QROUP LIBRARY 

Volumes 1-90, 46 disks rental— $45 

Volumes 91-176, 44 disks rental— $50 

SPECIAL! Rent all SIG/M volumes for $90 

K.U.Q. (CharlottMvllla) 25 Volumes— $25 

IBM PCSIQ (PC-DOS) LIBRARY 

Volumes 1-200, 5V« " disks $200 

174 FORMATS AVAILABLEI SPECIFY. 

Public Domain User Group Catalog Disk $5 pp. (CP/M only) 
(payment In advance, please). Rental Is for 7 days after receipt, 
3 days grace to return. Use credit card, no disk deposit. 
Shipping, handling & Insurance— $7.50 per library. 
(619) 9144)925 lnformatlon,(9-5) 
(619) 727-1015 anytime order machine 
Have your credit card readyl VISA, MasterCard, Am. Exp. 

Public Domain Software Center 
1533 Avohlll Dr. 
Vista, CA 92083 



LISTING 11. GETSCRN.PAS 



PROGRAM gatscrnf (fill* a hi ras display with data fro* 

m * i 1 a that ■*• savad to disk by wvicrn . 
Copyright 1984 by N. T . Car ntvi 1 a . 

Ptfuinon granted tor nonprofit um. > 



CONST GRAFSCREEN-2; (utf only hirti icrtai 

t*t PCP. INC) 

itl APLGR/G. INC) 

(*I APL6R/H. INC> 

TYPE 

*tr in(j76"»tnng[ 70] I 

byte-char ; 

screeni ine-array Cl.._BPt_] O* bytal 

*ig«ila-FILE o* acreanlinei 

VAR 

ana: char f 
scrn: integtr; 

PROCEDURE daisy; 
VAR i .^mtegerj 
BEGIN 

FOR i : -0 TO 300 DO 
FOR j:-l TO 500 DOt 
END; 

FUNCTION proapt anm (proapt : ttr i ng79l : char I 

VAR mi:ch«r| 

BEGIN 

mt i t a (proapt ) I 



FUNCT ION rotnt«rt (row, page: intagarl : intagtri 
(r»Jrul*tt the starting addr a* a corrnpondi ng a li 
VAR pagwOaae: integer | 
MGIN 



ith PCPI v. 2 CP/M} 



IF paqvl THEN pagwbase : -HI RESPA6E i ELSE pag«bas«: ^IRESPA8E2| 
'o— st art : -pageoase + «28a<row SHR 6) * (llroa SHR Zi MOD B) SHL 7) 
♦ llro« MOD St SHL 10)1 
f no; 

W*OCEDURE doit; (sieple raad a screen fro* dish 

L «r it* to spac 1*1 ad acreen) 
VAR 

* i lnas>: str ingt 1211 

* : + ig+ i la; 

I i nanua: integtr) 

ttap.'icrttnhnei (teaporarv array to hold s line from thai Krem) 
BEGIN 

■ritf CFi It to raad: ')! 

r»«dlnld lnaa) ; 



without claaring it) 



rtcet (* ) I 

hiresgr (scrn.FULLSCREENH (ihoM tha s< 
FOR linenup:»0 TO (MIVRES-U DO BEBIN 

(raad _BPL byte* fro* the file into te*porary storage) 

readtf , te*p> ; 

(write tha byte* to tha display — ory, starting at 
tha addrass that correspond* to the line numbmr} 

_wrho*tdsta<addr <te*p[ 1 J) ,r cms tart <1 i nenua, BRAFSCREEN) . BPL » I 
ENDf 



ClG 

END; 



■ (Ml 



(start tn text display) 

(install register-loading routines) 



BEGIN 

text*creen< 1 ) i 

hirespatcht 

scrn : -SRAF SCREEN 1 

REPEAT 

hi re*gr< scrn. FULLSCREEN) ; <ahom the scream without clearing it) 
dalay; 

textscreen < 1 > ; (return to the text display) 

•n»:-proaptant ( 'Rapl ace that with data froa a file"* *>t 
IF ani-'V THEN BEGIN 
doit; 
delay; 

text screen < 1 > ; 

«ni:-proaptan»<'0o it again'' ■>; 
END; 
UNTIL ans< >' V* J 
END. (end of PROGRAM getscrn) 



For those who would rather not 
key in these listings, they are available 
on disk in Apple CP/M format for 
$10.00. Send payment (VISA or 
MasterCard accepted) with your name 
and address to The Computer Journal* 
190 Sullivan Crossroad, Columbia 
Falls, MT 59912. 
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Z SETS YOU FREE! 



Free to create computer environments right (or you . . . free to automate repetitive tasks . . . free to 
increase your productivity. Z-System, the high-performance 8-bit operating system that flies! 
Optimized assembly language code — full software development system with linkable libraries of often 
needed subroutines —relocating (ROM and RAM) macro assembler, linker, librarian, cross-reference 
table generator, debuggers, translators, disassembler — ready to free you! 

New generation communications package provides levels of-flexibility. func- 
TERM III tionality, performance not available until now Replaces BYE and XMODEM 

master/server local area network capability . . . public or private bulletin board 
and electronic message handling are integral features . . . auto-dial/answer, menu install 
XMODEM (CRC/Checksum), MODEM7 Batch, Kermit, CIS, and XON/XOFF protocols . 
100-page manual $99.00 

Rolls Royce of message handling systems . mates with TERM III or BYE for 
Z-MSG most advanced overall electronic mail/file transfer capabilities . . menu 

installed . . . extreme configurability . . . many levels of access and security . 
word, phrase editor, field search . . . complete message manipulation and database 
maintenance $99.95 

Elegant, menu and command-line driven file and disk catalog manager. 
DISCAT Generates and controls multiple master catalogs, working catalog used for 

update quickness. Nine flexible modules easily altered by user for custom 
requirements. Works with Z shells (VMENU, VFILER, MENU), aliases, and multiple commands 
per line $39.99 

ZCPR3: Tha Manual Bound, 350 pages, typeset book describes features of ZCPR3 
command processor, how it works, how to install, and detailed command usage. Bible to 
understand Z-System $19.95 

ZCPR3 and l/OPS Loose-leaf book, 50 pages, 8-1/2" by 11", describes ins-and-outs of 
input/output processing using Z-System. Shows how to modify your BIOS to include I/O 
redirection . . . complements The Manual $9.95 

More mining links found — Z Application Progams! Fly with eagles! Our programs promote high 
performance through flexibility! Productivity results from dynamically changeable work environments, 
matching operator to tasks and machines. 

Above programs require 48K-byte memory, ZCPR3, Z-Com, or Z-System, and Z80/ NSC800/ HD641 80- 
based computer. Shipping from stock. State desired disk format, plus two acceptable alternatives. As 
payment, we accept Visa, Mastercard, personal checks, money orders, and purchase orders from 
established companies. We also ship UPS COD. 

Call or write to place order or to obtain literature. 
* \ 

EchelOll, InC* 101 First Street • Suite427 • Los Altos, CA 94022 • 415 948-3820 
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Editor 

/continued from page 1) 

mapped I/O transfer capability; two- 
channel, full duplex asnychronous serial 
communications with programmable 
baud rate generator and modem control 
signals; 12-source vectored program- 
mable interrupt controller; two channel 
16-bit programmable reload timer; 
clocked serial I/O port; programmable 
dynamic RAM refresh and timing; wait 
state generator for slow memory and 
I/O devices; and dual-bus interface 
compatibility with 68xx and 80xx 
families. It is currently available in a 
6MHz version and an 8 MHz version is 
promised. The higher clock speed plus 
instructions which operate in fewer 
clock cycles than the Z-80 and a har- 
dware 8-bit multiply with 16-bit results 
have produced some impressive ben- 
chmark results. We are currently 
working on a construction series for a 
HD64180 Single Board Computer, and 
are looking for articles on programming 
it. Micro Mint is announcing a very 
reasonable priced SBC, Echlon has 
their enhanced Z-System and an 
assembler ready, and Byte will be 
breaking a feature article. Keep your 
eye on this chip, it's hot and we will be 
carrying more information when 
available. 

WD65802 CPU for Apple Upgrades 

Western Design is finally delivering 
its WD65802 which is a plug-in 
replacement for the 6502, and provides 
16-bit accumulator, ALU, X and Y in- 
dex registers, and stack pointer, and 
can run existing 6502 and 65C02 code. 
The S-C Macro, ORCA/M, and Merlin 
Pro assemblers are ready for the 65802 
(they'll also handle the 65816), and it is 
rumored that Apple will bring out a 
new model II based on one of these 
chips. 

This chip allows Apple II users to 
upgrade to 16-bit registers for about 
$50 and still continue to use their 
existing hardware and software. Now if 
Apple would only release 800K high 
performance drives, the model U's 
would really hum. 

Reasonably Priced Software 

Many of the new programs are 
available for $100 or less, and the 
unrealistically high software prices 
may be a thing of the past. Some com- 
panies try to defend their high prices 
by talking about the man-years of 
development time and the high 
promotional and support costs, while 



they drive BMW's and throw $50,000 
parties. Eventually the marketplace 
will decide the proper price, and it is in- 
teresting to note that some of the best 
support comes from the lower priced 
software companies where you can talk 
to the original programmer and people 
care about their product and their 
customers. These companies have 
lower advertising budgets (no ten 
million dollar promos) which will raise 
hell with the slick four-color magazines 
which depend on these budgets. We 
should help support reasonably priced 
software by passing the word and 
telling others about programs that 
work and provide good support at low 
cost. 

Hacker's Haven 

If my workshop was in the attic I 
could call it A rt 's At tic, but it's in the 
basement and if my name was Dave I'd 
call it David's Dungeon. Since I can't 
think of anything better, I'll call it 
Hacker's Haven for now and hope that 
you will all understand that I'm using 
the original definition of hacker and 
NOT someone who breaks into 
systems. In fact, right now I don't even 
have a modem! 

I have added a Vista A800 8 " DSDD 
drive interface to my Apple II + , it sure 
is nice to have 1.2 Megabytes of high 
speed disk available. It's not a hard 
disk, but I have removable media and I 
picked up the interface for $50 and used 
it with one of my existing drives. Under 




CP/M 
MSDOS 



CP/M it can write either standard IBM 
format single density or double density, 
and using single density I can read and 
write to the disk with both the Apple 
and S-100 CP/M systems, which will 
make it easy to transfer files between 
the systems. I'll also run some bench- 
marks on this drive against the Apple 
drives. I received patch disks for DOS 
3.3, CP/M 2.2, and Apple Pascal. If 
anyone has experience with this inter- 
face I'd like to hear from them, 
especially if they have any information 
on patching ProDOS to run on this in- 
terface. 

The operating system is the most 
important part of a system, and CP/M- 
80 does have its shortcomings. I have 
acquired the ZCPM3 core and utilities 
from Echelon and will be bring it up 
this month (I hope). From reading the 
literature it will do a lot of the things 
that I missed in CP/M-80 2.2, and I'll 
keep you posted as I learn more about 
it. 

If I add the 65802 to my Apple with 
the 8" drive, and get a HD64180 run- 
ning with ZCPR3, I'll be content for 
some time while I learn how to use 
their new features (and still be able to 
run all my existing software). But this 
magazine isn't just about what I am 
doing — it's also about what you're 
doing. Drop us a line and tell the 
readers what you are working on, and 
what you'd like to do. If you have any 
questions or problems, let the other 
hackers help you find an answer. ■ 



AFFORDABLE 

ENGINEERING 

SOFTWARE 



TRSDOS 
PCDOS 



• LOCIPRO Root Locus — $69.95 

• ACTFIL Active Filter Design/Analysis — $69.95 

• STAP Static Thermal Analysis — $69.95 

• MATRIX MAGIC Matrix Manipulation — $69.95 

• RIGHTWRITER Proofreader & Writing Style Analyzer — $74.95 

• ACNAP2 AC Circuit Analysis — $69.95 

• DCNAP DC Circuit Analysis — $69.95 

• SPP Signal/System Anarysis — $69.95 

• PLOTPRO Scientific Graph Printing — $69.95 

• PCPLOT2 High Resolution Graphics — $69.95 




Engineering 

Professional Software 

i\ Z: Bjsines', \A Hy Suite , 
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Floppy Disk Controller 
/continued from page 261 
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Mew Products 



, Root Locus Analysis 

BV Engineering has added LOCIPRO 
to its line of engineering software. 
LOCIPRO provides control system and 
electronic engineers a simple means to 
quickly determine closed loop system 
stability from open loop transfer fun- 
ctions. LOCIPRO is a stand-alone com- 
puter program which quickly solves the 
locus of roots for systems up to 26th or- 
der and ten loop elements. Output data 
can be vectored to a line printer or data 
files. All program inputs are free for- 
mat and menu driven. Output files are 
compatible with other BVE products 
adding transient analysis and high 
resolution graphics. LOCIPRO is 
available for $72.95 under PC/MSDOS, 
CP/M-80, and TRSDOS in 121 different 
disk formats. For additional infor- 
mation and a free catalog call or write 
BV Engineering, 2200 Business Way 
J207, Riverside, CA 92501 , phone (714) 
781-0252. 

C Development System 

AGS has announced Smart/C, a fully 
integrated, pre-compilation develop- 
ment environment for the C language. 
Smart/C, which incorporates many 
elements from artificial intelligence 
research, is a productivity enhancing 
software tool. It allows the user to 
create, edit, test, and debug C 
programs, all before any compilation 
step. 

They claim that Smart/C supplys a 
complete set of tools for eliminating all 
syntax errors and most logic errors 
before any compilation is done, and that 
its interpretation is not incremental 
compilation, but true interpretation. 
Smart/C consists of the Environment, 
which provides syntax directed editing 
and interpretation of C source; and the 
Migrator, which allows C programs not 
created with Smart/C to take advan- 
tage of the editing and debugging 
capabilities of the environment. There 
is a Verbose capability available which 
prompts the novice user as to the next 
appropiate syntax element when the 
program is being created. 

Smart/C runs on several machines, 
ranging from the IBM PC, to the AT&T 
3B series, to the VAX 11/780 tm and 
runs on a variety of operating systems, 



including MS-DOS, UNIX tm System V 
release 2, XENIX and Berkeley BSD 
4.2. Pricing ranges from $500 for the 
IBM PC under MS-DOS to $10,000 for 
the DEC VAX 11/780 running Ultrix. 
For more information, contact AGS 
Computers, Inc., Advanced Products 
Division, 1139 Spruce Drive, Mountain- 
side, New Jersey 07092. 

Assembler and Debugger for Hitachi 
HD64180 Super Chip 

Echelon, Inc has announced two 
programs to support Hitachi's HD64180 
high-integration 8-bit microprocessor 
chip: ZAS, a machine code relocating 
macro assembler and ZDM, a debugger 
and monitor. 

ZAS produces Intel compatible HEX 
as well as Microsoft REL files. It's 
compatible with Digital Research's 
ASM, MAC and RMAC, with 
Microsoft's MACRO-80, and Xitan's 
TDL assemblers. 

Considered a universal assembler, 
ZAS converts Hitachi HD64180 in- 
structions (IN0, MLT, OTDM, OTIM, 
OUT0, SLP, TST, and TSTIO) into 
machine operation codes. ZAS also 
handles the complete Zilog Z80 instruc- 
tion set. Nestable conditionals and full 
expression handling, relocation by ab- 
solute, code, common, and data criteria, 
and complete macro expansion and 
library insert capabilities. ZAS creates 
8-bit standard SYM tables used by 
DSD, SID and ZSID debuggers. Fifty 
pseudo-ops are provided making for ef- 
fective and efficient Assembly 
Language code writing, for both ROM 
and RAM usage. 

ZAS comes complete with Microsoft 
compatible REL file linking loader 
(ZLINK), Intel-to-Zilog mnemonic tran- 
slator (ZCON), relative code file 
librarian (ZLIB), and source listing 
symbol-to-line cross reference 
generator (ZREF). 

ZDM, the dynamic debugger and 
monitor, provides quick assembly 
language code development and main- 
tenance. Twenty-one commands permit 
complete object code debugging and 
hardware port exercising. Beyond- 
normal commands: string search in hex 
and ASCII, send and Feceive I/O port 
bytes, verify if two blocks of memory 



are identical, show only branch 
statements, send all screen output to 
printer, examine prime and alternate 
registers. Plus math in hex, 
enable/disable interrupts and regular 
functions such as fill, go, input, move, 
display, read, set, trace, and untrace 
complete the command set. 

ZAS sells for $69.00 including a 70 
page loose-leaf manual, and ZDM sells 
for $50.00 including a 20 page manual. 
Both programs work with CP/M, MP/M, 
and Z and run on Z80. NSC800 and 
HD64180 based microcomputers. For 
OEM's and VAR's, Echlon offers ZAS 
and ADM with economical pricing and 
multi-year, volume buying 
arrangements. Echlon also produces 
the high-performance 8-bit operating 
system called Z-System (combined ZC- 
PR3 and ZRDOS) which is fully upward 
compatible with CP/M plus utilities and 
subroutines. 

Contact Echlon, Inc., at 101 First 
Street, Los Altos, CA 94022, or phone 
(415)948-3830. 

Data Acquisition Network 

Strawberry Tree Computers now has 
a network that links up to 64 computers 
running its Analog Connection PC data 
acquisition system, to a master com- 
puter up to 3500 feet away. The DNA 
network manufactured by Network 
Development Corporation transfers 
data at up to 1 million bits per second 
over a 4-wire cable between IBM PC, 
XT, AT or compatible computers. 
Remote computers can log data on the 
master computer or print on a shared 
printer while monitoring and con- 
trolling temperature, pressure and 
other inputs. Any computer, including 
the master, can run MS DOS programs 
such as Lotus 1-2-3 or dBase III for data 
analysis and process supervision. The 
slave can operate without disk drives in 
dirty environments. Operation of the 
network is not impared by failure of 
any remote computer. 

The prices are $695 for the Master 
Interface Card and Software, $395 for 
the Slave Interface Card, with the 
Analog Connection PC data acquisition 
interface starting at $690 for eight 
channels. For more information contact 
Walter Maclay at Strawberry Tree 
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Computers, 949 Cascade Drive, Sun- 
nyvale, CA 94087, phone (408) 736-3083. 

ProDOS Assembler for Apple He and 
He 

The S-C Macro Assembler Version 
2.0 is now available in both DOS 3.3 and 
ProDOS versions. They both support 
the full instruction set and addressing 
modes of the 6502, 65C02, 65802, and 
65816 processors, as well as Steve 
Wozniak's SWEET-16 pseudo- 
processor. 

The ProDOSS version includes all 
the familiar S-C Macro features, and 
adds some new ones. One new directive 
implements a form of text compression 
for programmer messages that 
squeezes text to an average of less than 
five bits per character. It also supports 
a new "blocked include" directive, 
which allows even larger programs to 
be assembled than was possible with 
the DOS-based version. 

The S-C Macro Assembler is NOT 
copy protected, and is compatible with 
the Apple II, II Plus, lie, and lie. Only 
64K RAM is required, but if more is 
available the ProDOS /RAMdisk may 
be used. Videx Videoterm and 
Ultraterm cards, standard He and lie 
80-column hardware, and hard disks 
such as the Sider and Corvus are fully 
supported. 

S-C Macro Assembler is priced at 
$100 for either the DOS 3.3 or the 
ProDos versions, or $120 for both pur- 
chased at the same time. An upgrade 
price is available for owners of previous 
versions. It is available from S-C Sof- 
tware Corporation, 2331 Gus 
Thomasson Road, Suite 125, Dallas, TX 
75228, phone (214) 324-2050 

Data Logging Software for IBM PC, 
XT, & AT 

Lawson Labs has added the PC64 
data logging software which allows up 
to 64 channels of analog input to be 
defined and scanned at a preset inter- 
val. Each channel has its own label, 
units label, offset and scaling factors, 
and high and low alarm limits. 16- 
channel strip chart recorder software is 
included, and the strip chart will run on 
an IBM graphics printer or any Epson 
compatible graphics printer. Data can 
be stored on disk automatically bet- 
ween scans, and the data files are fully 
compatible with Lotus 1-2-3 which can 
be used for data manipulation. Sam- 
pling can be done at rates of 1 scan per 
second to 1 scan per day. The software 



is not copy protected and is fully 
listable. A 128K IBM PC or equivalent 
with one disk drive and one Lawson 
Labs Model 140 A/D card is required. 
The price including manual is $150. 
Contact Lawson Labs, Inc., 5700 Raibe 
Road, Columbia Falls, MT 59912, phone 
(406) 387-5355 



SBC 180 Computer/Controller 

Micromint has developed a single 
board computer using the powerful 
Hitachi HD64180. The SB180, only 
4 x 7V2 " offers a Z-80 compatible CPU 
running at 6MHz, 256 bytes of RAM, up 
to 32K bytes of ROM, two serial ports, a 
parallel port, expansion bus, and an in- 
dustry standard 756A-compatible disk 
controller for up to four disk drives (any 
combination of 3 Vi", 5'A ",or8" drives. 
It can be used for a disk based com- 
puter system, or a battery-powered 
dedicated controller with 32K of ROM 
space, and can run standard 8080/8085 
and Z-80 software at up to twice the 
speed of a 4MHz Z-80. The SB180 can 
run CP/M 2.2, CP/M Plus, Z-System, 
MP/M II, TurboDOS, and Oasis 
operating systems. 



The SB180 with 256K bytes RAM 
and a ROM monitor is $369.00. A boot 
disk with the Z-System, limited 
utilities, and Super BIOS sco rce 
listings is $49.00. To order, or for more 
information, contact Ken Davidson at 
Micromint, 25 Terrace Drive, Vernon, 
CT 06066, phone 1-800-635-3355. 



DON'T PAY $700 

FOR DATA ACQUISITION 

SOFTWARE 

We offer full-featured, reasonably 
priced data logging software. Our 
software is well documented, unpro- 
tected and fully listable. 

64 - CHANNEL CAPACITY DATA 
LOGGING PACKAGE for IBM 

PC® $150 

128 - CHANNEL CAPACITY DATA 
LOGGING PACKAGE for 
APPLE II* $100 

HARDWARE SUPPORTED: 

IBM: Model 140 15-bit A/D 

7.5 sam/sec $265 

APPLE: Model 34 1 2-bit A/D 

40,000 sam/sec $325 

Model 38 8-bit A/D 
111,000 sam/sec $165 

Model 14 13-bit A/D 
15 sam/sec $175 

Model 40 Timer/Clock 

1 ms resolution $175 

BOTH: Model 20 Differential 

Thermocouple Thermometer 
with true cold junction 
compensation $175 

Model 17 16-channel differ- 
ential Multiplexer . . . $165 

LAWSON LABS, INC. 
5700 Ralba Road 
Columbia Falls, MT 59912 

Phone: 406 387-5355 



"BMOIM" 

Software In-Circuit Emulator 

Links your CP/M computer with any Z80 
based computer or controller that you may 
develop. All that is needed is BMON. 8K of 
ROM space, and a handshakeable bi- 
directable I/ O port (either RS232 or Paral- 
lel). 

Features: 

—Full program development debugger 
with Breakpoints, Snaps. Stops. & 
Waits. 

— Single Step program execution 

—Download file from CP/ M system to de- 
velopment RAM. 

— Upload Memory from development 
RAM to CP/M disk. 

—Two versions: Master BMON runs in 
your CP/M system. Slave BMON runs 
in your target system. 

Note: Requires Microsoft's M80 & L80 
assembler & linker to setup Slave 
BMON. 

8" SSSD Disk containing Master 
BMON, Slave BMON, CONSOL, 
BMONIO, CONSOUO, and Users 
Manual $49 95 

Shipped Via prepaid UPS 
—No COD or P.O. Box- 
Check or Money Order to: 

Barnes Research & Development 

750 W. Ventura St. 

Altadena. CA91101 

(818) 794-1244 

CP/M is a fradeTiart* of Digital Research mc 
M80 & LBO are trademarks ol Microsoft mc 
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KEYBOARDS FOR COMPUTER BUILDERS. Full 
ASCII, numeric pad. UC/lc, CAPS-LOCK, REPEAT, 
SELF-TEST! Brand new, hundreds sold to builders 
of Apples, Xerox 820s, Big Boards, etc. Parallel TTL 
output, strobe. 5 volts/100 ma. Custom case 
available. Keyboard $35. Documentation (21 
pgs. (/cable pkg. $5. Spare CPU/ROM $4. UPS in- 
cluded. Detailed specs on request. Electrovalue In- 
dustrial Inc., Box 376-CJ, Morris Plains, NJ 07950. 
(201)-267-1117. 

Voice Processor for the KAYPRO Computer. 

Unlimited speech contains all software. Call or write 
Busch Computer, PO Box 41 2, West Haven, CT 
06516. Phone (203)484-0320. 

S-100 68008 CPU BOARO. Detailed description in 
issue 16 of The Computer Journal. A&T$260, Kit 
$210, Bare Board $65. Prices include shipping. IN- 
TELUCOMP, INC. , 292 Lambourne Ave. . Wor- 
thington, OH 43085, Phone (614)846-0216 after 6 
p.m. 

S-100 Bus IEEE-488 Interlace Card with cable, 
manuals, and software for the North Star Horizon. 
Purchased new from Pickles and Trout in 1979 and 
used once. $100. Call Phil Wells at (406) 755-1323 
days of (406) 257-5326 evenings. 



Corvus 10MB Hard Disk for the Apple II plus, 
$888.00; Apple III Second Disk Drive, $199.00; 
Apple III SOS Device Driver Writer's Guide $19.95; 
BPI Accounting for Apple III (Requires Hard Disk) 
$99.00; Apple Writer 1.1, 16 Sector, $8.88; Apple 
DOS User's Manual (II, II plus, lie), $8.88; Apple 
DOS Programmer's Manual (II. II plus, He), $6.88; 
KAYPRO-Home Accountant by Continental, $49.00; 
Soroc IQ 130 Terminal, $399.00. All plus shipping. 
The Computer Place, 36 2nd Street East, Kalispell, 
MT 59901, Phone (406)755-1 323. 

THE SECURITY DISK. PROTECTED VS UNPROTEC- 
TED. At last, the best ot both worlds. Here is sof- 
tware designed to PROTECT YOUR PRIVATE FILES. 
SIMPLE PROTECTION TO MULTI-LEVEL CRYP- 
T0L0GY. Plus "DYSUN:;THE DISK UNL0CKER" 
WILL ANALYZE & UNLOCK COMMERCIAL "COPY- 
PROTECTED' ' DISKS, then recopy them to standard 
DOS 3.3 format. "DYSUN" will also RECOVER 
LOST DATA & REPAIR BLOWN DISKS. A special 
"SECRETS-TIPS-TECHNIQUES" program is also 
included. Not locked-up. Listable. Machine 
Language Source Codes included. Supports Apple 
II, II Plus, He, He. To order send $29.95 
CHECK/MO to B. ME. Enterprises, Box191-J, Kila, 
MT 59920. 



Morrow Decision I S-100 system with MPZ-80 CPU. 
DJ/DMA floppy disk controller. 256K static ram, 
Wonderbus I/O on mother board. Disk Jockey Hard 
Disk (HDCA) Controller, 801 floppy drive. 10MB 
hard disk, CP/M, Micronix Multiuser system, un- 
configured MP/MH, dBase II, Wordstar. Accoun- 
ting Plus. Excellent condition $3500. some trades 
considered. TCJ, 190 Sullivan Crossroad. Columbia 
Falls, MT 5991 2 Phone (406)257-91 19 

Book Sate— These books are offered at this price 
while the supply lasts. 
Zilog Z30-CPU Technical Manual. $1 50 
Real Time Programming— Neglected Topics 

byCaxtonC. Foster, $8 00 
CBASIC Users Guide 

by Osborne, Eubanks, and McNiff, $14 00 
Introduction to FORTH 

by Ken Knecht. $9.00 
FORTH Programming 

by Leo J. Scanlon, $13.00 
These prices are postpaid in the U.S. only TCJ, 
190 Sullivan Crossroad, Columbia Falls. MT 59912. 
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Books of Interest 



Apple II/IIe 

Robotic Arm Projects 

by John Blankenship 
Published by Prentice-Hall 
149 pages, 7 x 9" 

Robotics is an interesting subject, 
and as Blankenship states, "More than 
ever before, there is a need for anyone 
interested in computers and/or elec- 
tronics to learn about motor control, ar- 
tificial intelligence, and other robotic- 
related subjects." While there are 
many robotics books on the market; the 
serious ones assume that you have a 
Ph.D and are so theoretical that they 
don't help in average practical ap- 
plications, and the hobbyist books have 
little or no useful information. 

This book is a pleasant combination 
of fundamental information and simple 
demonstration programs for those who 
want to get started in this interesting 
field. The author's goal is to enable you 
to understand the basic principles 
through simple projects, so that you 
can create your own designs and not 
just imitate his work. The contents of 
the book are as follows: 

•Chapter 1 Introduction. Industrial vs. 
hobby robots, constructing the robot, 
what is a robot? software and inter- 
facing, robots can be fun. 
•Chapter 2 A Simulated X-Y Arm. 
Why simulation? simple videobot three 
dimensional video simulation, Using 
the simulator, BASIC X-Y simulator 
program. 

•Chapter 3 Intelligent Control of the 
X-Y Simulator. Defining the goal, 
command syntax, using the flowchart, 
designing by defining, logical control 
structures, folwcharting the modules, 
multipurpose modules, coding the 
program, BASIC Blocks World 
Simulation program. 
•Chapter 4 A Mechanical X-Y Arm. 
Construction of a physical arm, using 
surplus parts, motor control, electronic 
noise problems, optical isolation, open 
vs closed loop systems, eliminating 
bounce, software counters, Assembly 
Rev Counter program, input/Output 
ports, the 6522 VIA, plotting with the 
arm, BASIC X-Y Plot Demo program. 



•Chapter 5 Vision Systems. Types of 
Vision, restrictions and limitations, ob- 
jectives, a simple example BASIC 
vision 1 program, practical uses, scaling 
factors, BASIC Vision Algorithm 
program, centroids and vectors, con- 
densing the data, vision hardware, a 
HIRES SCRN function, HIRES SCRN 
function assembly program. 
•Chapter 6 A Simulated Jointed Arm. 
Why joints? trigonometry needed for 
joint simulation, coding the simulator, 
manual control of the simulator, BASIC 
Manual Jointed program. 
•Chapter 7 Intelligent Control of the 
Jointed Simulator. Manual vs computer 
control, converting X-Y coordinates to 
joint angles, converting to steps, 
algorithm to ensure that all joints will 
finish at the same time, BASIC In- 
telligent Control of a Simulated Jointed 
Arm program. 

•Chapter 8 Control of Stepper Motors. 
How a stepper motor works, step 
variations, half stepping, interfacing, 
bipolar and unipolar motors, program 
control, integrated circuit controllers, 
sample BASIC Stepper Motor Control 
program. 

•Chapter 9 Building a Jointed Arm. 
Flexibility, construction, attaching 
motors, the software, BASIC In- 
telligant Control of a Stepper Motor 
Arm program, controlling the motor. 
•Chapter 10 Positional Control of DC 
Motors. Why DC motors? comparision 
of Stepper and DC motors, overshoot, a 
test platform, the computer interface, 
designing the program, coding the 
program, BASIC Motor Positional Con- 
trol System program. 
•Chapter 11 Hobby Servo Motors. 
Using radio controlled model servos, 
generating the pulses from the game 
port, the interrupt program, Quad Ser- 
vo Drive System assembly program, 
BASIC Servo Control Demo program. 
•Chapter 12 An Arm for a Hand Pup- 
pet, constructing a robot puppet, inter- 
facing the motors, the software, In- 
terrupt Timing System assembly 
program, BASIC Puppet Controller 
program. 

•Chapter 13 Computerizing a Toy 
Arm. Why use toys? The mechanical 
connection, controlling the solenoids, 



sensory feedback, designing the sof- 
tware, BASIC Armatron Controller 
program. 

•Chapter 14 Man-Sized Arms. Degrees 
of freedom, making compromises, 
designing the manipulator, building 
working models, designing the wrist. 
•Appendix A Sources for Robot Parts. 
•Appendix B Optional Diskette Infor- 
mation. 

Although the book is rather thin (146 
pages of text), it is tightly written and 
contains a lot of useful information. 
Some of the subjects are covered in a 
mere pharagraph or two, which was 
done to avoid overwhelming the begin- 
ner with more information than he 
needs. Other books can be consulted for 
more details on specific subjects after 
the fundamentals are absorbed. The 
author has used BASIC for most of the 
programs, not because it is necessarily 
the best-suited language for robotic ex- 
perimentation, but because the 
majority of the readers will be familiar 
with it. The programs in the book are 
also available on disk for $19.95 for 
those who would rather not key the 
listings. 

This book should be useful for 
someone's first indroduction to building 
and controlling robotic devices using 
low-cost junk box and surplus parts. ■ 

Apple Hand He are registered 
trademarks of the Apple Computer 
Corporation. 
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"...received my moneys worth with just one 
issue..." 

—J. Trenbick 
". always stop to read CTM. even though 
most other magazines I receive (and write for) 
only get cursory examination..." 

—Fred Blechman, K6UGT 
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APROTEK 1000™ EPROM PROGRAMMER 



•f 



CIP 



only 
$250.00 




A SIMPLE, INEXPENSIVE SOLUTION TO PROGRAMMING EPROMS 

The APROTEK 1000 can program 5 volt 25XX senes through 2564. 27XX 
series Through 27256 and 68XX devices plus any CMOS versions of the above 
types included with each programmer is a personality module of your choice (others 
are only S 1 00 ea. when purchased with APROTEK 1000) Later, you may re- 
auire future modules at only $15 00 ea., postage paid Available personality 
modules: PM2716. PM2732. PM2732A. PM2764, PM2764A. PM27128. 
PM27256. PM2532. PM2564, PM68764 (includes 687661 (Please specify 
modules by these numbers). 

APROTEK 1000 comes complete with a menu driven BASIC driver programmer 
hstmg which allows READ, WRITE. COPY, and VERIFY with Checksum Easily 
adapted for use with IBM, Apple. Kaypro. and other microcomputers with a RS-232 
port Also included is a menu driven CPM assembly language driver listing with Z 80 
iDART) and 8080 182511 I/O port examples Interface is a simple 3-wire RS-232C 
with a femaie OB-25 connector. A handshake character is sent by the programmer 
after programming each byte. The interface is switch selectable at the following 
6 baud rates: 300. 1.2k. 2 4k, 4 8k. 9.6k and 19 2k baud. Oata format for program 
mingis "absolute code" (i.e., >t will program exactly what it is sent starting at 
EPROM address Oi Other standard downloading formats are easily converted to 
absolute (object) code 

The APROTEK 1000 is truly universal It comes standard at 11 7 VAC 50 60 HZ 
and may be internally jumpered for 220 240 VAC 50 60 AZ FCC verification 
(CLASS 81 has been obtained for the APROTEK 1000. 

APROTEK 10OQ ia covmrad by a 1 yaar oarta and labor warranty. 

FINALLY - A Sim pirn, Inauponaiva Solution To Eraatne EPROMS 



APROTEK-200 m EPROM ERASER 

Simply insert one or two EPROMS 

and switch ON In about 10 minutes. 

you switch OFF and are ready to 

reprogram. 

APROTEK-200™ only 545.00. 



APROTEK 300™ only $60 00 

This eraser is identical to APROTEK 
200™ but has a built m timer so that the 
ultraviolet lamp automatically turns off m 
10 minutes, eliminating any risk of overex 
posure damage to vour EPROMS 
APROTEK 300™ only $60.00 



APROPOS TECHNOLOGY 

1071-A AvenMa Acaao. CamarWo. CA 93010 

CALL OUR TOLL FREE ORDER LINES TODAY: 

1(800) 962-5800 USA or 1 (8001 962 3800 CALIFORNIA 

TECHNICAL INFORMATION: 1(8051 482 3604 

Add Shipping Per Item: $3 00 Com U.S. 96.00 CAN, Mexico. HI, AK, UPS Blue 




POWER THAT GOES ANYWHERE! 

Single Board Computer 

FAST - 6MHzZ80B' CPU 

POWERFUL - 64Kto256KRAM.2Kto64KROM 

- 5V," and 8" Floppy Controller SASI 

- 2 RS-232. Centronics Port 

FLEXIBLE - 50-pin I/O Expansion Bus 
SMALL - 5V x 10" 



DAVIDGE CORPORATION 
292 East Highway 246 
PO Box 1869 
BuelltonCA 93427 

'Z80 s d 'egiste'ea 'raoemar* ot Z>ioq 



(80S) 6M-959S 
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THE COMPUTER CORNER 

A Column by Bill Klbler 



It 



U is the hot time of the summer and 
computing is starting to take a back 
seat to other forms of recreation. I have 
had a chance to reflect and review my 
computing needs while my systems 
were shut down during the last few 
weeks of moving to a new location. My 
vacation is about to start (sure need one 
after moving all those boxes) and the 
industry as a whole is doing a two step, 
and I thought this would be a good time 
to review pending projects and ideas 
for them. 

Some months back I stated an in- 
terest in doing machine to machine 
linking and have since found several 
products already available. I usually 
use public domain software as my sour- . 
ce for most of my projects, and BYE 
and XMODEM will allow most users to 
handle their system to system needs. 
Packet radio links have still got my in- 
terest and you will see something later 
from me for sure. 

I received one inquiry on my putting 
together a FORTH ROM based system 
and all the problems that it implies. 
This idea has also become my next 
project and hopefully will be my next 
special article for The Computer Jour- 
nal. The idea here is first to check out 
the public domain disks for source code, 
go after the bugs and unknown 
problems, followed by implementation 
and uses. Now FORTH has some good 
points and some bad points, but for 
robotics or solar system control the 
idea of being able to tailor an operating 
system to consist of just the code 
needed for the project (and maybe por- 
table to other systems) is hard to beat. 
If someone out there has done this 
already and would like to write about 
it, give the editors here at TC J a call 
and I will go on to some other projects. 

I haven't got my hands on anything 
new lately, as the market for used 
systems is pretty bad. My old units will 
not sell and so I haven't any money for 
the new (used) stuff. With the market 
changes and the maturity of the 
systems, I am rethinking all my efforts. 
I am still planning on buying one of the 
68000 machines later this year, and 
maybe use it for the FORTH system. 



I'll be attending Micro Cornucopia's 
SOG IV (unofficial get-together) and 
should have some thoughts on my 
projects (and comments on the SOG 
too). What this is all coming down to is 
the state of the industry, pretty 
shakey. 

There has been a real shakeout in 
computer companies, but a most in- 
teresting fact surfaced last month. Ap- 
ple reported that over 60% of it's sales 
were for the TEN year old Apple II's. 
This amounts to about 450,000 systems 
by Apple (plus who knows how many 
copies) which is still a considerable 
amount of units. The software is not 
quite the same story, as very few new 
programs have been released. I liken 
this whole problem to autos, especially 
antiques, which are still rebuilt and 
sold and even driven a lot, with some 
units that are over 40 years old. Now 
computers aren't quite 40 years old but 
there are still a lot of us that will keep 
using our old systems, no matter what, 
and I expect to see some support to 
spring up in this area soon (other than 
magazines like TCJ). 

A few final comments before I grab 
my backpack and head out the door. My 
Remex drives are still working, the 
modified units have only an occasional 
error, while the unchanged one gets a 
lot. I have heard of others dying for 
ever, but have not gotten any infor- 
mation from our readers as to why, yet. 
The cost of print spoolers is dropping 
and for those who didn't build the one in 
TCJ I'll have some words about an S- 
100 unit next month. For you clone 
builders, check the layouts well as some 
bare boards need by-passes and tuning 
caps in some places to make them work. 
Seems some of the timing windows 
were rather poorly done and may need 
some slowing down just to work. These 
may be undocumented spots for 
capicators, and require trial and error 
work to get the correct value. 

Had some troubles with other mini 
drives, and remembered to look for in- 
verse logic. It never fails to catch you 
when you're sure you know what you're 
doing. A TEK drive wouldn't work 
right until all the switches were turned 



on and the drive selected switch turned 
off. So when faced with a series of swit- 
ch positions and the unit doesn't work, 
try reversing all logic, you will be sur- 
prised how often the documentation is 
wrong about this item. Also had a drive 
motor sieze up on me, seems the Oillite 
bearings had no oil. If you decide to 
take it apart, it is not for the bumble 
fingers, these are small and will give 
you problems getting the brushes 
altogether again. Try unbending the 
tabs at the back and putting the 
brushes in after partial assembly. Soak 
those bearings in a good light oil not 
WD-40 types (they will strip out the 
good oils). On some of the double sided 
drives, watch out when cleaning the 
heads. The floating head is just that, a 
floating head mounted by thin strips of 
metal. I got to rebend the metal gimbal 
of one that had been caught by a cotton 
swab, and bent badly out of shape. The 
unit now has a crease in it, but checked 
out OK after realignment. 

Now where is my freeze-dried 
food??? bye.... ■ 

Registered Trademarks 
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